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the Graphic Artisi The Complete Professional 

COMPUTER AIDED DESIGN 

& 

DESKTOP PUBLISHING 



System for the Atari ST 



"The GRAPHIC ARTIST is one of the first programs tl^at 
tries to toke odvantoge of tlie tremendous power of 
fhe Si . . . fhe first ST program to use ttte printer to its 
higtiest resolution and the results are extremely impres- 
sive . . . The GRAPHIC ARTIST can indeed produce 
protessional drawings, not available througli EASY 
DRAW . . quite an impressive product." 

— Current Notes 



cm 



PnaGRESBIVE 
COMPUTEn 
n f APPLICATIONS^ 




CIRtlE 09? DNRi*D[ftS SERVICE CARD 





USE THE BRAINS YOUR AlMI 

WASN'T BORN With. 



Right at your fingertips 
in CompuServe's Atari 
Forums. 

Our Atari Forums involve thousands 
of Atari users worldwide. These forums 
show you just how easy and how much 
fun it is to get the most from your Atari 
computer 

The Atari 8-bit Forum provides the 
chance to talk with Atari enthusiasts on 
all levels. You'll learn all kinds of useful 
information from all kinds of interesting 
people. It's the leading national Atari 
Forum. 

Devoted exclusively to users of the 
ST-series. the Atari 16-bit Forum pro- 
vides programs, textfiies, assistance, 
product reviews, transcripts of online 
conferences and more. 

The Atari Developers Forum is the 
authorized distribution area for all up- 
dates to Atari's registered software devel- 
oper's kit for both the 8-bit and 16-bit 



Atari Computers. Members may access 
conferencing channels, data libraries, 
free programs and software. 

Easy access to free software. 

• Download firsl~mle. non 'Commercial user- 
supporled software and utility programs. 

• Take advantage of CompuServe's inexpen- 
sive weeknight and weekend rales (when 
forums are most actiue. and standard online 
charges adjust !0C per minute). 

• Go online in most major metropolikm areas 
with a local phone call. 

• Receiue a $25.00 Introductory Usage 
Credit when you purchase your ComptiSerue 
Subscription Kit. 

Information you simply can't find 
anywhere else. 

Use the Forum Message Board to ex- 
change mail with fellow members. Join 
ongoing, real-time discussions in a 
Forum Conference with Atari luminaries 
like Sam Tramiel and Bill Wilkinson. 
Scan Forum Data Libraries for free soft- 
ware, documentation and contributions 
from Atari enthusiasts. 

(IfidEOn OH RUDERS SERVia URD 



Enjoy other useful services too, like 
electronic editions of your favorite maga- 
zines, newsletters and articles, including 
ANTIC, Family Computing, OMNI 
Online, and Electronic Gamer™ 

All you need is your Atari computer 
and a modem ... or almost any other 
personal computer. 

To buy your CompuServe Subscrip- 
tion Kit, see your nearest computer 
dealer Suggested retail price is $39.95. 
To receive our free brochure, or to order 
direct, call 800-848-8199 (in Ohio, call 
614-457-0802). If you're already a 
CompuServe subscriber, just type GO 
ATARI at any 1 prompt and see what 
you've been missing. 

CompuServe' 

Infcrmation Services, PO Box 2Q212 

5000 ArlinglQn Centre Blvd., Columbus, Ohio 43220 

800-848-8199 
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Solapak ST ^^^--"'^ 
Print Spooler IRam Disk 

Now with the "Solapak ST" print spooler you can: 

- print up to 8 files witli separate printing qualities at one 
time. 

- Configure to any parallel printer witti 32 user definable 
options. 

- Adjust line spacing, format your output, vary the print 
Speed, pause/restart printing and much, much more. 

The "Solapak ST" Ram Disk lets you: 

- configure up to 1 Mb and 128 files. 

- save time with a disk transfer rate of over 10 million 
bits/second. 

Includes user adjustable screen saver to help prevent image 
"burn-in". 

"Solapak ST" is easy to use and the fastest, most versatile 
and memory efficient professional print spooler and ram disk 
available for the ATARI ST. 

"Solapak ST" demo at your ST retailer or on BBS's 
nationwide. 

$39.95 Nolcopyprpleded 

Action Software - 69 Clementina St. Dept, SR 
San Francisco, CA 94105 - (415) 974-6638 

Mail orders: please include S3-00 S&H and Ga. 
residents add $2.60 sales tax. VISA, MC OK, 
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V ou are now holding the second issue of START-The ST Quarterly, the 
most professional and complete magizine devoted to the Atari ST computer 
Our fii^t issue sold out, although there may be a few copies in inventory for 
those of you who want the complete set. 

Finally the Atari is being recognized as a competitive machine Advertisers 
familiar to readers of MacWodd and PC have been approaching us. But what 
of the most important ingredient in a successful magazine introduction, the 
reader? Look at the letters in our Dialog Box, You readers raised some interest- 
ing and valuable questions. Let me answer those regarding content, subscrip- 
tions and frequency 

We had responses ranging from "great," and "fantastic," to "I'm disap- 
pointed," and "over my head." My editorial position is, if you own an ST, then 
START belongs in your mailbox, [ agree, our first issue had some very difficult 
material. Those of you who felt in over your heads should keep reading be- 
cause we intend to bring you comprehensive buying guides, technical tips that 
simply require your machine to be plugged in, and more power-user material 
like how to get the most out of your spreadsheets, communications software, 
and languages. 

Remember, the disk is included, so no typing. Just read and enjoy- let the 
computer do the rest. For you hacker types and developers, I think we've al- 
ready got you covered. You probably noticed the high-quality writers we've al- 
ready signed up, and you can count on more, 

I often tell our dedicated staff, we should address three groups in START, 
For those of you who are still deciding, we'll show you why the ST is a good 
buy For those of you who are new owners, we'll help you feel comfortable 
with this powerful system, and help you choose software And, for those of 
you already familiar with the system, rest assured we will bring you the most 
complete and useful information, programs and tutorials. 

All of this is easy to say, and difficult to do. After all, we're only two issues 
old. We'll make some mistakes, but a good, powerful, useful magazine takes 
some time to mature. 

Many of you know we offer a $59.95 one-year subscription. You get four is- 
sues of START, each including a 3.5-inch disk, plus 12 monthly issues of 
Antic-the Atari Resource Why Antic? 

Our reasoning went something like this: in Antic we have already built up 
the number one circulation, sales and adverrising base for Atari computing. 
We already have withstood the test of time-four and a half years-in an un- 
forgiving market. Last year we started the ST Resource secdon in Antic, and it 
grew. Non ST readers worried that the ST would take over the whole ma^zine, 
so we promised we would limit ST coverage to no more than 40 percent of 
Antic's editorial pages. Now this coverage is necessarily less comprehensive 
than start's and the ardcles are shorter and easier, but it's still 300 to 400 ex- 
tra pages of ST material every year, and probably just right for many of you 
who are learning the ST. 

As your skill increases, and you demand more thorough material, then 
there you have it, another quartedy issue oi START, more difficult but much 
more to chew on. 
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EDITORIAL 



Well, it Still seems right to me, so I'm 
going to ride with this package awhile. If 
we deliver you START and Antic, and 
leave you excited, filled with ideas, 
more confident, and looking forward to 
another issue, then we will have done 
our job, delivered you good value for 
your money 

As for frequency, I think as we better 
understand our changing market, you 
can expect START- Die ST Quarterly to 
become at least bimonthly. 



James Capparell 
Publisher 



Answer: 1040ST " 

Question: Which computer is the first 
in the world to give you 1 Megabyte of 
power for under $1,000? 

The 1040ST is a major breakthrough in personal computers. 
Indeed, it's the world's first computer with an original list 
price that represents less than $1 per l^ilobyte. 

To give you an idea of what an extraordinary accomplish- 
ment that is, let's look at the price-per-kilobyte figures for 
some well-known competitors. 

The Macintosh,™ for example, comes in at over $4 per 
kilobyte, the Amiga'" isover $5 per kilo- 
byte and the PC AT'" is a whopping $9. 

In contrast, the I040ST comes in at 
an incredible 98 cents per kilobyte and 
a total price of just $999" for the com 
plete system: CPU, disk drive and 
high- resolution monochrome 
monitor. 
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INTRODUCING STING 

Congratulations on your premiere issue. 
It looks great, and I'm impressed by the 
talent you have writing for you and the 
diversity of the articles. David Small's 
"Voodoo Computing" started a small 
debate among my programmer friends, 
but most of us agreed with his maxims. 

We have just formed an ST users 
group in the Peoria, Illinois area. We call 
it STING-for ST INformation Group- 
and our only rule so far is "no pirated 
software either for demonstration or for 
trading." We'd like to hear from others 
who want to exchange newsletters. 
David Stambaugh 
109 Florida Avenue 
Washington, IL 61571 
Thankfijor the encoumgement. START will 



publish user group information as we get it; 
see Resources this issue. 

NO PROGRAMMER 

After reading the hrst issue ol START I 
agree with Mr Capparell's editorial that 
he has published a ma^zine for those 
who want "high-end information that 
requires grounding in computer funda- 
mentals" But what about the rest of us? 

I'm a 37 year old teacher, and the ST 
is my first computer I bought a few 
games and applications for it, and I 
LOVE IT My problem is that your arti- 
cles make me feel like a fourth grader 
who has wandered into a college 
physics class, I'm not a programmer and 
don't have the rime to become one 

i know you can't please ever)'one, but 



I think I'm representative of many new 
ST buyers -enthusiastic and ready to 
spend on hardware and software (if 
only teachers made more money). 

I think it's great to publish a ma^- 
zine for the ST only, and it's great to 
show Atarians how to use their com- 
puters in new exciting ways, but if you 
want me as a subscriber, you'll have to 
take things a little slower 
Larry Jones 
Pocatello, ID 

We acknowledge your concern and its 
echoes jrom other readers. See our Editorial 
this issue, and remember, a subscription to 
START includes 12 monthly issues of Antic 
magazine, with substantial ST information 
and programs for the be^nner Also, you 
don't have to be a programmer to run and ► 
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IF YOU CAN FIND A BETTER 
PROGRAM WE'LL BUY IT FOR YOU! 

Full GEM interfacing, convenient Quick Keys, 
and many other unique features of our own. 



ST 




WORD WRITER ST ol^J 



II 

;er 

A full-featured, professional word pro- 
cessing system for home and business 
use. You get: 

• A Continuous Spell Checker that 
identifies misspelled words as you are 
typing your document. 

• An additional 85,000 word, built-in 
Spell Checker that checks your entire 
document - at your command! 

• On-Screen underlining , Italics and 
boldface - as you write. 

• An Outline Processor that quickly 
organizes notes, facts, and ideas in 
convenient outline format. 

• Every other feature you'll need for 
everyday word processing, plus most of 
the features found in more expensive 
programs. 

With Timeworks you get more 
than software. . . 

You Get Our Customer Tectinicaf 
Support Team - free to all registered 
users. 



Data Manager^ 
ST 




MIA MANAGER ST "wHi^'' 

A complete general information Stor- 
age and Retrieval System with report 
writing, business graphics, and label 
making capabilities. Plus, you get: 
-' Flexibility that allows you to modify 
your data base structure by changing 
the size or position of tields of informa- 
tion - at any time. 

A complete Report Writer that gener- 
ates customized data reports. You 
specify the title, location, and sequence 
of each column. 

An extensive Business Graphics 
Package with pie charts, bar charts, 
line plots, point plots, hi-lo-close stock 
price plots, and more. 
A Label Maker that prints your impor- 
tant information onto all types of labels. 

With Timeworks you get our Money 
Back Guarantee* 

If you can find anything that works better 
for you - and it's available - we'll buy it 
for you. Details inside every Timeworks 
package." 



SwiffCalc^S 




SWIFTCALC ST ^Sideways 

A state-of-the-art spreadsheet for home 
and business use. You get: 

• 8192 rows and 256 columns provide 
up to 2,048,000 cells (locations) in 
which to place information. 

• Super Graphics graphically display and 
print out business information using pie 
charts, bar charts, line plots, point plots, 
hi-lo-close stock price plots, and more. 

• Windowsaliowyou to work on two sec- 
tions of your spreadsheet simultaneously. 

• Sideways lets you print all columns on 
one continuous sheet . . . sideways, 

• Help Screens, help you use the pro- 
gram - without referring to your manual. 

• Formatting - Choice of five formats: 
Decimal (up to 9 places); Graphics; 
Exponential Notation; $ Sign & 
Commas. 

Vou Get Our Liberal Upgrade and 
Exchange Policy - Details are inside 
every Timeworks package. 




More power for your dollar 

Timeworks, Inc. 444 Lake Cook Road, Deertield, Illinois 60015 
312-948-9200 



For the Atari 520/1040 Computers.* 

Suggested Retail List Price: 
$89.95 each 

Available now at your favorite 
dealer, or call Timeworks. 

TO ORDER CALL: 
1-800-535-9497 
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enjoy the programs on the START disk. 

WANTS THE DISK 

1 picked up my first copy of START and 
was disappointed to find it had no disk. 
The vendor said because it came both 
ways it was cheaper for him to sell it 
without the disk. How do I get the disk? 
Joseph Santorelli 
Rome, NY 

START is a magazine/disk combination, not 
intended for separate sale. In order to get 
established we are making some nondisk 
copies available, especially to newsstands. 
Many Walden and Dalton bookstores, and 
retail computer stores sell the disk version, 
and START disks are also available from 
Antic Publishingfor $10.95 plus handling 
(see order form in this issue). 

DOESNT WANT DISK 

Just picked up a nondisk copy oi^ 
START. It is amazingly good, but I'm 
desperately broke, so I don't own an ST 
yet. I hope the nondisk version will 
continue to be available for those of us 
who don't yet have the machine, 
Nicholas Bodley 
New York, NY 

We will continue to make nondisk copies 
available for retail sale, but subscriptions 
copies all contain disks. 

GOBBLEDYGOOK 

I bought a 1040 ST, and I'm in love. 1 
have no programming knowledge, nor 
do I wish to acquire any. My computer 
provides an easy and enjoyable vehicle 
for using many business, hobby and en- 
tertainment programs that are elaborate, 
and yet a snap to run. 

Imagine my excitement when I 
found START, a magazine devoted en- 
tirely to the ST. Also imagine after I 
dropped $15 to hnd the same old gob- 
bledygook I have worked hard at avoid- 



Answer: 1040ST 
Question: Which computer was 
specially designed for people 
who hate to v/ait? 

Let's face it, any time you spend waiting on a computer is 
time wasted. That's why Atari" buiit the 1040ST with a sizzling 
ciocli speed of 8 MHz. 

And with 1024K t)ytes of Random Access Memory the ST™ 
gives you an incredible combination of power and speed. (The 
PCAT,™ for example, has 512K of memory) 

So you'll spend time working on your ST instead of 
waiting on it. 

In addition, the 1040ST costs an 
amazingly low $999", which makes it the 
first computer in the world to deliver 
1 Megabyte of memory for under $1,000. 
(The PC AT costs about $4,500.) 

So if you haven't checked 
out the ST yet, what are you ^iiiS££S&3^-5-?3i=? 
waiting for? 

ATARI, ST, and 1040ST are Irademarks ol Alan Corp. m 

■ emalidnal Busmess \ii^ , 





;kATARr 



ing. I'd like more software reviews in 
depth, and more information about pe- 
ripherals. Please find some way to help 
those of us who spend money happily 
on our ST, but merely want to use it, 
Betsy Dobrick 
Coral Springs, FL 

Wc plan to always have enough general in- 
fonnation and useful programs to make 
your purchase worthwhile. See Antic maga- 
zine for reviews and news of ST products. 
Also see START'S new Clipboard for hints 
and tips the nonprogrammer can use. 

BOUNCING ALONG 

Having seen Amir's Bouncing Ball pro- 
gram and also the Fuji symbol variation 
run on the ST, I have a burning desire to 
know how it was done. I'd love to create 
impressive graphics like these. 
R.G. Summers 
Ren ton, WA 

Your wish is our command. See 
FujiBoink! in this issue, also source code for 
it on your START disk. 



ABSORBING START 

Yesterday 1 got the first issue of START. 
There's a lot in it to absorb I may be ab- 
sorbing until the next issue is pub- 
lished. What a great start! 

But 1 must say I was sorely disap- 
pointed not to find a word processor 
program reviewed. I have 1ST Word, but 
abandoned that as soon as I found Re- 
gent Word, which I fully expect to use 
for a long time to come, 

I hope to see carefully researched 
reviews in START that will help us 
readers choose useful programs, 

1 want us all to succeed, to grow and 
get better 1 thank you and anticipate a 
satisfying future, 
Joseph C.P, Alvarez 
Omaha, NE 

The infonnation on ward processors in this 
issue's START CHART should wet your 
whistle. ► 
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NeverEnding 
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Save the world of "Fantasia" in this thrilling adventure. As the hero Atreyu, 
you face the trials and terrors of the "All-Consuming Nothing." Enter the quest 
in this richly illustrated and highly imaginative graphics-text adventure game. 



l>aU|soft 



.We Challenge You 



19808 Nordhoff Place, Chatsworth, CA 91311 (818) 886-5922 
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rAST SATISFACTION 

Please run some articles that give com- 
parative results for different hardware 
and software. How about a cfiart show- 
ing compile and execution times for a 
number of C compilers for the ST? 
Brian Cole 

CompuServe 73107,1756 
You TTiusf have read our minds. Sec C com- 
paiison anicle and START CHART nn word 
processors in this issiif. 



USE US OR LOSE US 

I'm a long time Atari user (with the em- 
phasis on user), and Antic reader (I've 
still got every one). I've stuck through 
some thick and much thin, but I never 
became a programmer Ever)' man has 
his limitations, and plumbing and pro- 
gramming are just two of mine. 

Don't get me wrong; 1 want to read 
programming articles to understand the 
logic of what's going on, but more than 
thai I want fundamental instruction, 
with tips and techniques about the 
machine's many features, I want useful 
utilities (like Tom Hudson's printer 
drivers), and answers to my questions 
(like how do you use the mail merge in 
ST Writer?). 

Your first editorial referred to us "ex- 
perienced users," but I'm not sure your 
content does, I realize the machine is 
new. as is your publishing efl^ort, START 
looks very good, seems well written, but 
needs time to mature. 

I'll wait and see. Thanks for the 
ma^zine, keep up the good work, and 
remember that many, if not most, of us 
want to be users, not programmers, 
Jim Cummings 
Pennsauken, NJ 

Roj!,i;i; Pennsdufeen, Wc read you loud and 
clear Observing new vector Over and out. 



Answer: 704051" 
Question: Which computer builds 
in multiple features instead 
of hidden costs? 

It seems that a lot ofour competitors design stripped down 
computers, and then charge extra for every feature and upgrade 
you add. 

Atari* doesn't do that, because we believe the features and 
level of performance you want should be built in to begin with. 

That's why the 1040ST gives you a full Megabyte of memory 
While the competition only gives you the chance to spend big 
dollars trying to improve their memories. 

Another trick they use is to make sure 
their interfaces don't meet industry stan- 
dards, so you're locked into their system. 
In contrast, the ST'" uses standard inter- 
faces across the board, suchas the RS-232C 
port for serial modem communica- 
tions and the parallel interface for 
an industry standard printer 

Of course, the ST's best 
built-in is the price, which is an 
incredible$999"! 

ATARI, ST, an(J1040ST are Irademarksol Atari Corp 
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ALERT BOX 



Chades Roberson of Vienna, VA noticed two errors in Dan Matejkas "AL and C rou- 
tines" from the first issue of START. On page 65. an erroneous semicolon appeared: 

M:--d;=*s; 
Unless the first semicolon is removed, a compile-time error will ensue The second 
error concerns the MC68000 AL code presented as output from the Alcyon compiler 
on page 66. A bra to the second move inside moveloop was inadvertently left out. 



WHERE'S MY DISK? 

START is a magazine with its programs on disk. Normally the disk is bound into 
the magazine and sells on the newsstands for $14.95. 

But some of you ST enthusiasts want to read START first, so we have provided 
a hmited number of copies without disk for $4.00 each. 

If this is your situation, you can complete your copy of this issue of START by 
ordering the companion disk direct from us, for $10,95 plus S2,00 shipping and 
handling. See the handy order form. 
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PLAY 
REVERSI 

ON YOUR DESKTOP 

A GEM TUTORIAL AND A GREAT GAME 



by Christophe Bonnet 



this desk accessory 
version of Reversi (or 
Othello) is the perfect 
executive toy for those 
lengthy spreadsheet 
sessions. French pro- 
grammer Christophe 
Bonnet uses this classic 
computer game to 
demonstrate how to 
create a desk ac- 



cessory. 
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Although ihc 68000 prores- 
sor in the Atari ST is fully 
capable of ainning several 
programs simultaneously, the current 
version of GEM does not support such 
multi- tasking. It docs, however, support 
"multi-programs!' When a program is 
designee} as a desk accessory and 
properly installed, it can share Desktop 
space with up to six other GEM pro- 
grams. During operation of any one of 
these programs, the others cease fore- 
ground acrivity. Thus, desk accessories 
do not provide true multi-tasking, 
though they can be a convenience. 

Desk accessories, such as the famil- 
iar Control Panel, are programs that 
have been designed and compiled 
specifically to be accessories. When 
placed on the "boot" disk, GEM recog- 
nizes these files by their -ACC extender 
and loads them into a safe place in 
1<AM, Titles for each accessory will ap- 
pear in the '^Desk" drop-down panel on 
the Menu Bar and will therefore be ac- 
cessible from within any GEM program 
displaying the Menu Bar The titles are 
created by the accessory programs and 
arc not necessarily the same as the pro- 
gram filenames. More than one desk ac- 
cessory may be included within a pro- 
gram file, but GEM supports a total of 
six desk accessories, no matter what the 
number of program files. 

Many desk accessories are available 
through the public domain, such as cal- 
culators, clocks, and slide puzzles. 
Commercial desk accessories are also 
beginning to appear The advantages as 
well as the limitations of a program 
designed as a desk accessory suggest 
certain creative directions. In this case, I 
chose the ubiquitous computer game, 
Rcvcrsi. It has appeared in various 
lorms on practically every computer 
Irom mainframe to micro. As an ST desk 
accessory, it provides a refreshing spot 



ol strategic entertainineni during long 
hours at the computci: 

REVERSI RULES 

Revensi is a popular ]Drograinniing chal- 
lenge. The mles of the giime are verj' 
simple, but de\'elopinga good strategy 
takes skill, Reversi is found on many 
computers because the g<rme mechanics 
are easy to understand and the graphics 
requirements minimal. (The tokens on 
mainframe versions are usually made 
up of X's and O's.) 

In our version of Reveisi, the human 
player always takes the black token and 
the ST computer the white. Each side 
alternately places one token of its own 
color on an unoccupied square, so that 
the following rule is respected: 

The token must be placed so that an 
imaginary straight line, drawn from that 
token to any other token of matching 
color will cut through one or more 
tokens of the opposing color (See Figure 
J.) 

Following a move, all opposing 
"sandwiched" tokens flip to the active 
player's color So, if black's token was 
placed on the bottom "?" in Figure 1, the 
board will change as in Figure 2. 

With each move, you must take at 
least one opposite-color token between 
two of yours or "pass" for that move. 
The ^me continues with each side al- 
ternately placing tokens and capturing 
pieces unril all squares are occupied, or 
no legal move is possible. The winner is 
the player with the most tokens of his 
or her color 

USING THE REVERSI 
DESK ACCESSORY 

The I^eversi desk accessory file is found 
within the REVEI^I.STQ folder on your 
START disk. Since it is a desk accessory. 



copy the file E^VERSI.ACC to a boot 
disk, then turn on your ST with this 
disk in the main drive Now, click on 
the REVERSI label that should appear in 
the Desk drop-down menu, and the 
Reversi window will appear in the mid- 
dle of your screen with two tokens for 
each side preset in the middle of the 
board. 

As with most desk accessories, you 
may click in the title area and drag the 
Reversi window anywhere on the Desk- 
top, Though you may not size the win- 
dow, you may close it by clicking on the 
upper-left corner box. Unless you re- 
boot, Reversi will remember your last 
position and you may continue your 
^me as you left off. The current score 
is on the right side of the window. 

You are black and you move first. 
Point the mouse cursor where you want 
to place your token and click the left 
button. If your choice is legil, the com- 
puter will place your token and flip the 
appropriate opposite tokens. It will then 
rake its own rum. Continue in this way 
until all squares are filled or there are 
no more moves. After the winner is 
declared, you may play again by choking 
anywhere within the window. It you 
can't make a legal move, resign your turn 
by pressing any key on your ST. 

THE PROGRAM 

[[ you plan on compiling Reversi from 
the source code on the START disk, 
please see the Disk Instructions page in 
this issue for details re^rding the files 
related to this article The program was 
written with Alcyon C from the Atari 
Developer's Toolkit, Other Cs may re- 
quire some modification. 

A small part of Reversi code is taken 
from ACCSKELG, which stands for "ac- 
cessory skeleton^' and may be found in 
the Developer's Toolkit, Those parts are 
indicated both in the lisnng and in the 
following analysis, ACCSKEL.C is ex- ► 
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REVERSI... 

actiy what it sounds like: a skeleton 
structure to make your own code into a 
desk accessory. 

Looking at REVERSl.C on your 
START disk (or on a printout if you in- 
sist on doing it the easy way), you can 
see that the only external file needed is 
GEMDEFS.H. The first duster of 
#define scatemencs makes the code eas- 
ier to read, and the second group takes 
care of the only XBIOS calls we use, 
thereby eliminating the need to 
#includ£ OSBIND.H, Following this are 
a number of global variables including 
several from the original ACCSKEL.C. 

The second declaration group con- 
tains variables used by the g^me 
subroutines- The array b_grid[l[l will 
contain the values of each game square; 
positive values represent good squares 
and ne^tive values bad ones. (A few 
quick games will quickly demonstrate 
why some squares are "bad".) These 
values will change during the course of 
a ^me, but b__init[IIl is the same array 
holding the starting values for the 
squares before the first move occurs. 
c_grid[]n is an array of codes showing 
the contents of each square: l=empty 
square, 2=player, 3 = computer, and 
O^border (not a valid square). 

Notice, among the other variables, 
phase and adv These are used in some 
procedures to tell the computer which 
side is playing. A value of two indicates 
human and three computer; phase 
represents the current player and adv 
represents the opponent during a move. 

Two standard GEM routines, open_ 
vworkO and open_window{), open 
the virtual screen workstation and open 
a window of specific size and attributes 
lor the Reversi playfield. Both routines 
are from the ACCSKEL.C source code. 

Following these two procedures is 
the main() entry point ol the program. 
This routine is called by the GEM shell 



immediately before displaying the 
Desktop. In this section is appl_init() 
which should be the first function in 
any GEM program. The menu_ 
registerC) function places the desk ac- 
cessor)''s menu item string, "Reversi;' on 
the Desk menu. Also in mainC) are 
screenO and init(), initialization calls 
for the game itself, which will be ex- 
plained later in this article. Following 
this is multi(), which contains our 
" psuedo-multitasking" routine. 

THE ROUTINES 

The portion of the program which ena- 
bles the desk accessory to Interact with 
any GEM application is multi(). The 
AES function evnt_muItiC) continually 
checks for GEM calls until you turn od 
the power or press the reset button. The 
purpose of evnt_multi() is to wait for 
specified events chosen by the pro- 
grammer When the event occurs, the 
operating system interrupts the current 
application and begins the appropriate 
program-or desk accessory. The 
specified GEM events for Reversi are 
MU_MESAG, MU_BL)TTON, MU_ 
KEYED, MU_M1, and MU_M2. 

MU_MESAG is tor specific window 
events (sizing, moving, closing, etc.), 
MU_BUTTON is the mouse button 
state (down or up), MU_KEYBD 
represents keyboard input, and MU_ 
Ml and MU_M2 are mouse position 
events. Mouse position events occur 
when the mouse cursor enters or leaves 
a specific rectangle, in this case, when 
the cursor exits or enters the Reversi 
window. With this information, we can 
change the cursor form to a pointed 
hand if it is in the window. 

Throughout all of multi(), the pro- 
gram dispatches the various calls in or- 
der to execute various tasks (window 
moving, cursor modification, accessory 
call by Menu bar, etc.). The multi() 
function is normally found in all GHM 
programs using the Menu Bar. 



board() 

Following a window updating message 
from GHM. or when you open the 
Reversi window, boardC) is called upon 
to draw the window (^me board, 
tokens, score, etc.). Most of the func- 
tions used in board() are from GEM 
VDl (line drawing, ellipses). The draw- 
ing parameter variables are adjusted de- 
pending upon resolution so the game 
will work in any mode. 

set_cllp() 

ACCSKELC provides both set_clip() 
and do_redraw(). The set_clip() rou- 
tine uses the size parameters of a given 
rectangle to "chp" any screen graphics 
which are drawn beyond this rectangle; 
do_redraw redraws any rectangle por- 
tions which have been "clipped" from 
the Reversi window by other windows. 
For example, when you drag a window 
on top of the Reversi one, then remove 
it, parts of the Reversi window must be 
redrawn. This function finds the parts 
and processes the subsequent drawing. 

playerO 

I3unng the player's turn, player() is 
called. It first converts the mouse X and 
Y coordinates (captured by evnt_ 
muhiO) into grid square coordinates 
ranging from zero to eight. If the cursor 
is really pointing on a square, player 
subroutine sub_lC) is called, 

atari() 

The atariO procedure contains the core 
game strategy for Reversi. The program 
first scans the c_grid array for empty 
squares, then checks their playability 
with verifyC ), which returns either zero 
(not a valid move), or the number of 
opposing tokens which would be 
flipped by this move. Then atari() as- 
signs a specific value to this square, de- 
pending on number of returned tokens 
and the strategic position of the square: 
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FIGURE 1 U's whiles turn. All poiiibk moves are fJuiwn with (he qiie^tinn mark (?) 
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turn() 

One compleK game mm includes both 
the human and the computer and is 
handled by tum(), which is called from 
the multiC ) procedure whenever the 
player presses a key or clicks in the 
window. First, tum() checks the end 
Rag to see if the game is over If so, 
init() is called to redraw the game 
board and reset the squares to their 
starting values. Otherwise, player() is 
activated- {See above) 

If the player's move is valid, atariC) 
determines the computer's decision. At 
the same time, the program checks for 
an end-of-game situation (all squares 
played; score[2l+scorel31=64, or both 
sides could not play anywhere: 
pass==2). 

bistly, turn() uses the VDI function, 
wind_sct{) to add the player prompt: 
"Your move. . .\0'' ^ 



Value = (b_gridlx]Iy] * 3) + Hip FIGURE 2 ll\ 

Because the number ol returned 
tokens is more important near the end 
of the ^me, this value is affected by the 
course of the game (This is a personal 
choice. You can modify the scoring to fit 
your own strategy.) 

The computer then chooses the best 
square value and plays it; change(v,w). 
If there is no playable square, it resigns 
for this turn; (point= = - 99). 

displayO 

'lo update the score on the right side of 
the window, displayO uses VDI func- 
tions. Further down in the listing, 
rectangleC) draws a filled rectangle of a 
chosen color using the VDI v_barC) 
function. Here, it is used to erase the 
previous score before writing a new 
one. Much of displayO is devoted io 
converting the score numbers to strings 
lor the VDI v_gtext function. 



i' blacks fimi AU pns.si/i/i' moves art' :^hnwn with the qnesLinn mark (?) 
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Looking for a desk accessoiy? 
There are plenty available, and 
the supply is growing. Here is just a 
partial Ust ol ST desk accessories 
which may be found commercially, 
or free on CompuServe or die Atari 
BBS. 

Michiron leads the pack in desk ac- 
cessories which include: 
ALT-Alt-key macros make your life 
easier Up to 36 programmable com- 
binations, ($29.95) 
Calendar-A complete appointment 
and reminder calendar, including 
alarm clock. ($29,95) 
Comermflfi-This monster multi- 
function desk accessory includes cal- 
culatoi; notepad, clock, phone dialer 
and directory, and a g^me thrown in 
for fun. ($49.95) 

Michtron, 576 S, Telegraph, Pontiac, 
MI 48053, (313)3.34-5700. 
CIRCLE 218 ON READER SERVICE CARD 

Batteries Included's Thunder! 
($39.95) is a real-time spelling 
checker See Mark Skapinker's article 
in this issue for more on this pro- 
gi-am. Batteries Included, 30 Mural 
Street. Richmond Hill, Ontario I.4B 
1B5, Canada, (416) 881-9941. 
CIRCLE 219 ON READER SERVICE CARD 



Apex Resources is distribudng a Brit- 
ish product called Rhythm ($34.95), 
which is a desk accessory calculator 
in the format of a small spreadsheet. 
Apex Resources, 17 St. Marj'S Court, 
Brookline, MA 02146, (617) 
232-9686. 
CIRCLE 220 ON READER SERVICE CARD 

The Catalog will soon release Crystal 
($24.95), an accessor)' that lets you 
access all GEM Desktop commands 
(including some never implemented 
by Atari) while within other GEM 
programs. The Catalog, 524 Second 
Street, San Francisco, CA 94107, 
(800) 443-0100 ext. 133. 
CIRCLE 230 ON READER SERVICE CARD 

COMPUSERVE 
ACCESSORIES 

Get on line, type GO ATARI! 6, then 
browse through the data libraries. 
We found most ol these in DL3, 
though some are also from DLO and 

DLL 

PL/ZZLEACC-A tilc-sJide puzzk 
BICAL2ACC-A three-resolution cal- 
culator 

BLL'E.ACC -Turns your Desktop blue 
without needing the Control Panel. 
CALCACC-Another calculator; take 
your pick. 
CALHND.ACC- How about a desk 




CRAB5.ACC-Nasty litde critters from 

Alex Leavins. 

DIRPRl.ACC- Prints disk director)' in 

condensed mode on Gemini lOX. 

DMPNEC.ACC-NEC printer screen 

dump written in Personal Pascal. 

P!A'PNL.ACC-A fixed Control Panel 

that maintains date and time on 

reset. 

RAM.ACC-Tells you how inuch free 

RAM is left. 

SCRSAVACC -Turns off your screen if 

you leave )'our CRT 

MITES. ACC- April fool's day joke. 

Similar to CRABS.ACC. 

RAMDSKACC-This is just one of 

many RAMdisks in the libraries, 

ATAR] BB5-(40a) 745-5308 will put 
you online with Atari, Go to SIG #8 
for ST goodies. Among the more 
than 200 programs to download are 
the following accessories (many ac- 
cessories listed above are also in the 
Atari BBS): 

CLOCKAACC-A graphic analog 
clock for your Desk. 
DJG1CL0K.ACC- Or, how about a 
digital clock? 

9 7KiMM.ACX- Like CompuServe, 
there are a lot of iMMdisks here 
SNAPSHOT. ACX-Ssvcs GEM screen 
in DEGAS format, 
EMULATORACC-Updated VT52 
emulator 

CLi.ACC- Command Line Inter- 
preter 

PALLETACC-Adjust your color pal- 
ette without the Control Panel, 
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sub_l() and sub_2() 
The sub_l( ) function checks if the 
player's chosen square is empty belore 
going on to sub_2(), which uses 
verifyO (see below) to get a count on 
the number of opposing tokens before 
flipping their colors. 

verify! ) 

The verify( ) function scans all eight 
directions from a specified square for 
valid, opposing tokens. The variable for 
the number of opposing tokens in one 
direction is called flap, while flop (the 
number returned by verify( )), is the to- 
tal number of opposing tokens found in 
all eight directions. 

change() 

The change( ) procedure is the most 
complex one in Reversi. It draws a token 
on the board window, then updates the 
necessary variables to reflect the 
changes. 

After activating a clipping rectangle 
within the window, and choosing some 
pleasing values for the drawing mode, 
the VDl v_elUpse() function draws the 
played token on the screen. 

As mentioned, all graphics within 
Reversi are designed to look the same 
regardless of resolution. To correct for 
vertical deformation in medium resolu- 
tion, the -X adjustment values are dou- 
bled when in this mode. Similady all 
high-resoluhon drawing values are ad- 
justed to be twice as big as low ones to 
create the same size board in all three 
modes. 

Next, all directions from the played 
square are scanned for opposing tokens. 
The tokens are placed into the variables 
(c_gridl]ll=phase ) and onto the 
screen (v_eUipse). For each returned 
token, the score of both sides is 
modified accordingly in 
scorelphasel + + and scoreladvl . 

Finally, ■wind_update is recalled to 
signal the end of window modification. 



modifyO 

After a few games, you will notice that 
different squares have different strategic 
value during the course of play; in fact, 
the overall value of each square closely 
depends upon the status of its adjacent 
squares. If we want an acceptably 
challenging gime, we must adjust the 
values of the squares appropriately. That 
is the purpose of modify( ), which is 
called after each move. Only some 
squares are examined, Co save memory 
space (and because 1 didn't want to 
spend months on this problem). I urge 
you to customize this routine for your 
own use. The best game results will 
come from improving this portion of 
the program. 

stopO 

As indicated by Its name, stopO is 
called when no more moves can occur 
A brief diagnostic message appears in 
the window usin^ I'.ic win(l_scr() 



initO 

The init() function initializes all the 
b_gridl]|] array variables (importance 
of each square) with those in b_initllll. 
Also, the c_gridl]ll array (content of 
the squares) is initialized with a one 
(empty) in each square, a zero (border) 
in all peripheral rows and a two (player) 
and three (computer) in central squares, 

wait() 

The delay loop wait(} is necessary. 
Without it, the computer responds too 
fast for the player to see where the to- 
ken was played, 

screen!) 

During desk accessory initialization, 
screenO is called once by main()- It 
checks the current screen resolution, 
with getrezO, then allocates the appro- 
priate values to the drawing variables 
used for window, board, tokens and text 
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MODEMS/HARD DISKS 

.'.,A !« 'M. J94 
■i\!l '.■.•.'.\ S149 


> 


29 99 
26 99 


AtflRI 520 St COLOR 




HAYES 1200 . 1399 


FINANCIAL COOKBOOK 


39 99 


ATARI 520 St MONO 




SUPRA HARD DISK * 


SUNDOG 


29 99 


flTARISF354SSDO. 


$169 




BUSINESS LEHERS 


37 99 


ATflRISF314DSDD . 


$239 


SOFTWARE 


HABA HIPPO C 


59 99 


ATARI SM 124 COtOR MONITOR 


J349 


VIP PROFESSIONAL 149,99 


EASY DRAW 


109 99 


ATARI SM 1224 MONO MONItOR 


1169 


UniCEC 


H & D BASE 


69 99 


ATARI HARD DISK 




GRAPHICS ARTIST ., ,' 


ST FORTH 


39 99 


ATARI IBM EMULATOR 




MEGAMAXE. .. 189.99 


PERSONAL PASCAL 


59 99 






DB MASTER 41.99 


HABA WRITER 


59 99 


PRINTERS 




OB MAN 


HIPPO SOFTWARE 




PANASONIC KX-P1091 


. $299 


DBONE ... . ' 


CARDS 


3199 


PANASONIC KX-PI092 


. $379 


BORROWED TIME . . 35.99 


GOLD RUNNER 


29 99 


ATARI SMM-S04 


$239 


HACKER , ,, , 33.99 


PERSONAL MONEY MGR 


38 99 


EPSON FX-35 


$499 


MIND SHADOW 35,99 


ST TALK 


15 99 


HP LASER SET 




MUSIC STUDIO 42.99 


.MASTERTVPE 


29 99 


HP FONT CARTRIDGES 




GOLF .. 26.99 


ONE WRITE A/ R 


79 99 


HP PtOTTER 




STRIP POKER 30,99 


FLIGHT SIMULATOR 


39 99 


"■Call loj our SPECIAL tOW PRICES Minimijm Shipoing Charf 1 00 




Adv/amced Computer Compamy 




TO ORDER CALL TOLL FREE 1.800.272.2525 (Maryland ord 


rs call 1-301-876-8350) | 


VISA • MASTERCARD 


CHOICE • C.O.D, • CHECK • 


MONEY ORDER 


1 


Advanced Computer 


• 28? Ea5t Green Street • We5tmin5ter, MD 21157 1 
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THE 

RIGHT 

START! 

Subscribe to STart, 
the ST Quarterly, while 
there is still time to 
receive the PREMIERE 
ISSUE. 

Quantities are ^ 
limited, however, so 
please don't delay! 

Remember, in addi- 
tion to 4 issues of STart 
and four S'/j inch pro- 
gram disks, you also 
receive— FREE— a full 
year (12 issues) of Antic, 
which features the ST 
Resource every month. 

So — for complete ST 
coverage — look for 
Antic and STart and be 
sure that you have all 
the information you 
need to get the most 
out of your new ST. 
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THE AMAZING 

MOUSETRAP 

ANNOY I NG MENU-DROPS 

AND 

HOW TO AVOID THEM 



by Dan Moori 



and David Smal 



There you are, working on your 
program. The mouse is near 
the top of the page With the 
delicacy of a microsurgeon, you avoid 
that overzealous menu bar as you move 
items around onscreen. 

But, oh no! You breathed on the 
mouse! It jogs up a millimeter and a 
drop-down menu bops right on top of 
your file icon - for the fiftieth time this 
hour! Aiigh! 

Tired of this scenario? Fmstrated by 
interfering drop-down menus? Weary of 
nagging obstacles? 

Then what you need is the Dandy 
Dan Moore MouseTrapl 

With this amazing program, you 
have not one, but two programs in one! 
The first routine, The BerUn Wall, pre- 
vents you from ever hitting the menu 
bar accidentally; it erects a wall between 
the main screen and the menu bar Try 
as you will, you cannot cross up into 
that menu bar The second routine, The 
Amazing Clicker, makes the right mouse 
button pop you up to the menu bar, no 



matter where you are You can be at the 
bottom of the screen, the top, or (God 
forbid!) visiting IBM headquarters in 
Boca Raton, and if you press the right 
button, boom! You're in the menu bar, 
and (gasp!) the menus pull down. 

1 know, you're stunned. But try to be 
calm, ft is all in one program, 
MOUSTRAP.PRG. Slip it inside a sleep- 
ing AUTO folder on your boot disk, and 
you're set. 

Just how did I accomplish this mira- 
cle? It all started one dark and stormy 
night, f accidentally pulled down a 
menu bar, and decided there had to be 
a better way. Somewhere, a dog was 
barking. So, I went hunting for the low 
memory variables that control the 
mouse. Since they aren't documented in 
the Atari papers. I had to look for them 

The search method was rather novel. 
First, using an XBIOS command, 1 in- 
structed the video chip to begin dis- 
playing memoiy at location 0, This gave 
me a bit-map view of the first 32K of 
the hard way. 



''M 



acintize" 



your drop-down menus 
and prevent cursor clut- 
ter. The Amazing 
MouseTrap will lock out 
the menu bar until you 
really need it. No more 
accidental drop downs. 
Program and listing are 
in the MOUSTRAP.STQ 
folder on your START 
disk. ►• 
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memory. While moving the mouse 
around, 1 looked for blinking pixels 
which seemed to represent the mouse X 
and Y registers. Upon finding them, 1 
measured with a ruler from the top of 
the screen, divided against a 32K screen 
size, and got an approximate memory 
location of the blinking pixels, I then 
used SID, the Developer's Kit debugger, 
to decermine the exact location. No kid- 
ding, that's how 1 did it. 

My stunningly commented listmg il- 
lustrates the action of the program. (See 
MOUSTRAPS in the MOUSTRAESTQ 
folder on your START disk.) Each 
mouse exception, I intercept a three- 
byte, relative mouse packet (button, X 
delta, Y delta), then calculate where the 
mouse will end up after the current 
movement is complete. If the mouse 
will end up at the top of the screen, I 
cmelly prevent it by zeroing the Y com- 



ponent of the mouse movement. Then, 
there's a right button check. If the right 
button is depressed, 1 tell it to move up 
128 pixels four times. This ensures that 
no matter where it is on the screen, it 
ends up at the top in one magic jump. 

You will note that I wedge this rou- 
tine in the "mouse-packet exception 
vector" whose address can be deter- 
mined with the keyboard-vector XBIOS 
call. 

So much for the heart of the pro- 
gram. How do I make it stay resident in 
memory? I first tried MOUSTRAP as a 
desk accessory, but room for those is 
precious and limited, so instead ! went 
for a terminate-and-sray- resident pro- 
gram designed for an AUTO folder 
There is a catch here, alas. After AUTO 
folder programs are run, GEM reinitial- 
izes the mouse vectors through 
InitmouseO. effectively demolishing 



my own custom vectors. To solve this, I 
stole the Trap 14 jump vector, and 
prevented GEM from clobbering my 
jump table. 

Bells and whistles included making 
it work with the color monitors (less 
scan lines in the sensinve region), ad- 
ding real live comments to the code, 
and polishing off a six-pack from the 
fridge to get me through. 

Users of the few programs that use 
the right button should note that 
conflicts can occur with the MouseTrap. 
Don't load it in with DEGAS or 
NEOCHROME, but othem'is& you will 
probably be fine, ■ 

(Editor's note: The MouseTrap code can 
be adapted to your own ncjarious schemes. 
One of the practical jokers at START 
created MOUSEGAG.PRG (also m the 
MOUSTRAESTQ folder). Sneak it into a 
fiiend's AUTO folder and watch thefim.} 
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Springfield, Virginia 22150 

(703) 644-8881 

Telex 269728 XLNT UR 

• Compose for 5T console speaker o: 
MIDI synthesizer 

• Keyboard or mouse entry 

• Smart editor checks beats 
entered per measure 

• All parameter info displayed 
during playback 

• Print high quality sheet music: 

- Add lyrics Be other notations 

- Include graphics 

- Print single voice 
or combination 

• Conforms to MIDI 
standard 

• Supports 
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Let the Composer 

in you come out. 
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• riexible composing tool: 

Change key & time signatures 

Insert, delete St copy measures 

- Copy from voice to voice 

- Change instruments measure by 

neasure for any voice 

Alter tempo measure 

by measure 

- Control synthesizer 
portamento 

- Capability to 
transpose notes 

- Load /Save rhythms, 
single voice 

or compositions 



/ Dennis Young S; Len Dorfman 

Includes four compositions! 
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Another Great Simulation from Sid Meier - 
Author ofF-15 Sfn/ce Eagle 

Now he takes you from the cold, thin air and limitless space ofF-15 Strike Eagle down into 
the dark depths of the Pacific Ocean inside an Annerican Worid War II submarine for a 
realistic, action-filled simulation — * 






Thrill to the initial slglitlng of the 
enemy's strike force in your peri- 
scope as their ships come into your 
range. But watch out — the enemy's 
escorts have just sighted you. You're 
the hunter — but suddenly — you've 
become the huntedl 

As Commander, you must sinli their 
ships and keep your submarine from 
being destroyed — if you can. Will you 
select a quiet patrol sector in the 
Marianas Islands or choose the 
dangerous waters off the coast of 
Japan? Is a submerged daylight 
periscope attack best or do you 
charge in on the surface at night 
using only radar bearings to guide 
you? Do you fire a spread of your pre- 
dous torpedoes or can you close the 
range and pick off the enemy with a 
single torpedo shot? These decisions 
and many more are yours to make as 
you take your place among the elite 
ranks of the SILEINT SERVICEI 

Its exciting — and its fun. Its 

another great Micro Prose simulation 
— and if s called SILENT SERVICE. 
Look for it now on your 
dealer's shelves. 



^^^ 

Sf 



^^. 



^ff, 



<> 

I %//^ 



'/ kX 



Try These Other 
Real Life Simulations 
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Al APPRENTICE 

EXPLORE EXPERT SYSTEMS WITH XLISP 



by Christopher F. Chabri 



M%n introduction to 
Artificial Intelligence — 
its languages and its 
methods — including an 
examination of LISP 
and a working expert 
systems program writ- 
ten in XLISP. Look in the 
folder XADVISOR.STQ 
on your START disk. 



Artificial intelligence lias at 
last arrived for the Atari 
community. With the 16-bit 
ST line, Atari has provided a computer 
whose capabilities approach those of 
advanced systems used for university 
and industrial research. At a traction of 
the price. Atari enthusiasts now have 
the power to experiment seriously with 
artificial intelligence in languages like 
LISP and PROLOG, 

WHAT IS ARTIFICIAL 
INTELLIGENCE? 

As an idea, arcificial intelligence (Al) 
provokes both fear and philosophical 
controversy. Many enthusiasts possess 
an ahnost rehgious faith in Al, while 
others violently resist the very notion 
that a machine can he made to think 



like a human being. But though they 
will dispute its ultimate feasibility, 
defenders and detractors alike usually 
agree that Al as a science is mysterious, 
fascinating, and often misunderstood. 
Assuming Al is at least theoretically 
possible, what exactly do we mean by 
artificial intelligence? We could discuss 
this endlessly, but I propose, as a work- 
ing definition, that A! is a science com- 
posed of three closely related areas of 
investi^tion; 

• ROBOTICS: By this 1 do not mean 
the study of industrial robots, mechani- 
cal arms, etc., bur a general research 
program whose ultimate goal is the con- 
struction by whatever means are neces- 
sary of a complete and artificial simula- 
tion of a human being. Many Al 
opponents have criticized this goal of Al^ 
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because it has serious philosophical 
and social implications. It is still far 
from being achieved after 30 years of re- 
search, 

• COGNITIVE SCIENCE: This is the 
study of cognition, or the processes, 
structures, and mechanisms of human 
thought. Many psychologists working in 
this area use computer models to help 
them learn more about the brain. 

• APPLICATIONS: Making computers 
more useful to people by applying the 
theories and techniques of Al, We will 
concern ourselves primarily with this 
engineering side of the discipline, writ- 
ing experimental programs in Al lan- 



Among Al researchers interested in 
our third objective, there has been con- 
siderable confusion over what consti- 
tutes an Al program, or appHcation. 
A^in, I adopt a pragmatic definition: Al 
programs are useful software systems 
[hat exhibit some behavior that would 
be considered intelligent or demanding 
intelligence if displayed by a human 
being, 

PRACTICAL 
APPLICATIONS 

Applied Al research concentrates on 
several different areas, most notably the 
following: 

• NATURAL LANGUAGE PROCESS- 
ING; Programming computers to 
understand "natural" languages such as 
English is important for database 
management and query. Rudimentary 
front-end programs for microcomputer 
databases can translate requests such as 
"Show me last month's national sales 
figures broken down by region and 
product" into the system's query lan- 
guage Another system under develop- 
ment reads newspapers and composes 
summaries of their content. 

• COMPUTER VISION: Much re- 
search is concentrated on vision, an im- 
portant capability lor robots and optical 
scanners. Ver)' simple programs can be 



constructed to identify shapes in three- 
dimensional scenes, compare and 
match objects, and so on. 
■ MACHINE LEARNING: The ability 
of the computer to learn, to acquire new 
skills and knowledge, may be the "miss- 
ing link" in Al. Much of the work in 
learning is exciting and relatively recent, 
but practical applications have yet to be 
investigated extensively. 
• GAME PLAYING: Chess computers 
represent a significant achievement of 
Al research. The best program today is 
stronger than 99 percent of human 
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players and continues to improve In 
backgammon, a computer had already 
defeated the world champion by the 
late 1970s. 

• SYMBOLIC MATHEMATICS: 
Machines have always been good at nu- 
meric calculations, attaining blazing 
speeds multiplying, dividing, etc. But in 
the 1960's Al researchers began to pro- 
gram for symbolic operations, such as 
differentiation and integration of func- 
tions, MACSYMA, a popular expert sys- 
tems program, was the eventual out- 
growth of that early work, and is now 
used widely by engineers for most of 
these operations. 

• EXPERT SYSTEMS: The most suc- 
cessful and visible outgrowth of Al re- 
search, expert systems are programs 
which mimic the reasoning process of a 
human expert when attempting to solve 



a particular class of problems. Expert 
systems are currenriy used in a wide va- 
riety of applications including law, 
medicine, electronics, chemistry, geol- 
ogy, finance, and the like. Later, we will 
explore expert systems in detail and 
build a simple expert-systems program. 
But first, we need the tools with which 
to build it. 

Al PROGRAMMING 
LANGUAGES 

Most Al programming is done in 
specialized languages-not C, Pascal, or 
assembler (heaven forbid), the lan- 
guages normally used to develop ST 
applications-but usually either LISP or 
PROLOG. 

LISP is an acronym for LlSt Process- 
ing because its primary data strucmre is 
the list. It was invented by John McCar- 
thy, the man who coined the phrase 
"artificial intelligence" in the late 1950's. 
It is one of the oldest programming lan- 
guages, and today's main dialect, Com- 
mon LISP, bears a close resemblance to 
the early versions. Nevertheless, LISP is 
still a modem language that is used for 
at least 90 percent of all Al research 
programming. 

There are several reasons for this 
popularity. One is that LISP is well- 
suited for symbol manipulation, as we 
shall see later Another is that LISP pro- 
grams can be both interpreted and 
compiled. The former allows easy 
modification and experimentation, 
desirable in a research setting, while the 
latter provides the execution speed 
necessaiy for a commercial product. 
Finally, LISP has proved worthy as a 
general-purpose programming language. 
Word processors-even enhre operating 
systems have been constructed in LISP, 
and its use is spreading to other appli- 
cations. 

PROLOG, which stands for PRO- 
gramming in LOGic, is a language that 
was developed in France around 1970 
by Alain Colmerauer and his colleagues. 
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A declarative language, it was a first at- 
tempt to realize the ideal of logic pro- 
gramming. Rather than explicitly state 
which steps the computer is to perform, 
and in what order they are to be ex- 
ecuted (imperative or procedural pro- 
gramming), the programmer declares in 
logical form the relationships and facts 
of the algorithms and data, and lets the 
computer [ake care of the control. At 
first this is a difficult structure to grasp, 
being foreign to most programmers. But 
PROLOG is quite powerful if used cor- 
rectly and has been chosen by the Japa- 
nese for their vaunted Fifth Generation 
project. 

An important trait shared by LISP 
and PROLOG is their homogeneity. Pro- 
grams and data have the same stmcture, 
and it is a simple matter for programs ro 
create new procedures or modify them- 
selves during their execution. Tr,' doing 
that with C or Rascal! 

EXPERT SYSTEMS 

One ol the first scientists to recognize 
the commercial potential of artificial in- 
telligence was Edward Feigenbaum of 
Stanford University, He is generally 
credited with inventing the expert sys- 
tem, a type of Al program that is sup- 
posed to be able to solve difficult prob- 
lems the same way a human expert 
would: by bringing a large body of ex- 
plicit knowledge to bear on the situation 
at hand and somehow using it to de- 
duce a solution. 

An expert system normally consists 
of four parts: a knowledge base, the en- 
coding of the knowledge necessary to 
solve the problems for which the sys- 
tem is designed; the inference engine, the 
software that draws conclusions from 
the knowledge and the facts of the case; 
one or more databases of relevant facts; 
and some sort of user interface. We could 
define an expert system as a program 
that is expert in some area, but then we 
could consider a calculator desk acces- 
sory' an expert system in the domain ol 



arithmetic. While this is certainly not 
untrue (can you multiply faster than 
your computer?), it trivializes the class 
of problems for which expert systems 
are designed: domains without unified 
theories but rather large bodies of disor- 
ganized knowledge that experts must 
draw upon to make decisions. 

Most expert systems in use today are 
rule-based. Their knowledge is 
represented as a collection of heuristic 
rules that specify precisely what conclu- 
sions can be made under which cir- 
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cumstances, and sometimes with ap- 
proximately what certainty of 
conectness. Such production rules 
usually take on a relatively simple IF- 
THEN form like these examples from 
well-known expert systems: 

IF: the gram stain of the organ- 

ism is negative, 
the morphology (shape) is rod, 
the aerobicity is anaerobic, 
THEN: the organism is bacteroides, 
IF: the context is layout and as- 

signing a power supply, 
an sbi module of any type has 

been put in a cabinet, 
the position it occupies in the 

cabinet is known, 
there is space available in the 

cabinet for a power supply, 
there is an available power 

supply, 
THEN: put the power supply in 
the cabinet in the available space. 



The first example comes from MYCIN, a 
pioneering medical diagnosis system 
developed at Stanford over the last 
fifteen years. The second is from XCON 
(formerly Rl), a program in daily use at 
the Digital Equipment Corporation to 
configure VAX computer orders. The 
two rules share a common structure 
that looks like this: 

IF: <antecedent condition 1> 

(AND) 

<antecedent condition 2> 

(AND) 



<antecedent condition n> 
THEN: <coiisequent attion(s)> 
(are all performed) 

Normally, each condition can take on a 
truth value of either TRUE or FALSE. A 
condition is presumed FALSE until 
proven TRUE; this is known as the 
closed-world assumption. The classical 
rule of inference used to make deduc- 
tions with these rules is called Modus 
Ponens, and it states the apparently 
obvious: 

Given a rule: A implies B, 
and given: A (is true), 
we conclude: B (is true). 

In our case, this means that if all the an- 
tecedent conditions are TRUE, then the 
consequent actions are performed. 
These could be simply assignments of 
truth values to other facts, or maybe en- 
tire procedures to be executed (in LISP 
expressions to be evaluated). 

Note that a rule Itself is context- 
independent; that is, the quantum of 
knowledge it embodies is always ap- 
plicable within the domain of the ex- 
peruse The XCON rule above uses the 
first few antecedents as a guard to es- 
tablish the situations in which it is ap- 
plicable, but as a whole the rule is 
context-independent. If we tr)' to use it ► 
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in the wrong context, it will just fail 
with no undesirable side effects, and wc 
can go on to the next one. 

Notice that these production mlcs 
are a declarative form of knowledge 
representation, akin to the logic pro- 
gramming concept introduced earlier in 
the discussion of PROLOG. The rules 
say absolutely nothing about how or 
when they will be executed: all the con- 
trol information comes from the infer- 
ence engine itself, which decides espe- 
cially the order in which to use the 
rules. The rules could have associated 
"priority" values, for instance, but it 
would nevertheless be up to the infer- 
ence engine to refer to those values for 
guidance. 

The program we will examine is 
XADVISOR.LSP on your START disk, 
XADVISOR is a production system in- 
terpreter (a generic inference engine) 
written in XLISP that embodies some of 
the principles introduced above. You 
may be surprised to see that the entire 
program, including comments, is just 
160 Hnes long! This includes the infer- 
ence engine and the user interface, but 
not the knowledge base The program 
will work with any knowledge base in 
any domain whatsoever as long as its 
format is syntactically acceptable (as 
will be described later). 

ADVANCED 
CAPABILITIES 

There are several capabilities common 
in real-worid expert systems that are 
missing from XADVISOR, including the 
following: 

• CERTAINTY FACTORS: In diagno- 
sis, we can rarely be completely certain 
of our results; rather, we have degrees of 
confidence in the correctness of our 
reasoning. Some expert systems use 
statistical tools like "Bayes Theorem" to 
calculate the certainty of deductions 
based on the certainties of the antece- 
dents being true and the certainties of 
individual rules being applicable. In this 
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The files you'll need can be found on 
your START disk in the folder labelled 
XADV1SOR.STQ. Copy them to a new 
disk before using or modifying them. A 
complete version of XLISP (v L5b) has 
also been included on your START disk. 
Piease note: We have had to compress 
XLISP in order to fit it on the disk. You 
must "unsqueeze" the XLISP program 
before it can be used. See the Disk In- 
stmction page for further instructions 
on this. Interested readers should ob- 
tain the XLISP documentation and 
source code. There are at least three 
possible sources: 

• User groups. Many have a ver- 
sion of XLISP in their pubhc- 
domain libraries or on their Bulle- 
tin Board Systems. 

• CompuServe Check Data Librar\- 
3 (Utilities) of the ATAR116 Fo- 
rum. To speed your search, use 
the keyword "XLISP" (what else?). 
The version posted here (v, I,5b) 
is the same used during the de- 
velopment of XADVISOR and this 
article, 

■ The Catalog. An XLISP disk has 
recently been added to the ST 
Public Domain section. 

Wherever you obtain XLISR be 
sure to get version 1.5b or higher, as 
well as the manual and the INITLSP 
file In the CompuServe distribution, 



several examples and the complete C 
source code are available. The follow- 
ing instructions and suggestions as- 
sume that you are using XLISP 1.5b; 
we have not tested other versions at 
this time, though we have no reason 
to suspect that later versions (1.6 and 
up) should behave much differently. 

y If you received an INIT.LSP with 
I your copy of the XLISP inter- 
preter, replace it with the version on 
the START disk. It ensures that 
enough memory is allocated for the 
XADVISOR program and performs 
several other useful services for you. 

Make sure that both INITLSP 
^ and PPRINTLSP are in the same 
directory as the XLISP program. In- 
stall XLISP as a "TOS-takes 
parameters" application on the GEM 
Desktop. If you like give it a docu- 
ment type of LSP (It is a good idea to 
give all your LISP files this extender, 
for this and other reasons we shall 
see later) 

3 Locate XLISP and double-click 
on its icon. A dialog box will 
open, prompting you for parameters. 
You can enter as many filenames as 
you wish, but be sure to leave off the 
,I^P extender; XLISP will add it to 
whatever you type. If you don't want 
to load any files right away, just press 

1 Re turn I. 
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A The XLiSP interpreter will load 
"i" and run. First, the message 
"XLISP version 1.5b, Copyright (c) 
1985, by David Betz" will appear at 
[he top of the screen. Second, XLISP 
will tr)' to open the file INIT.LSP and 
evaluate all the expressions it con- 
tains. Afterwards, or if INIT.LSP can- 
not be found in the defauh directory, 
XLISP will similarly load the files you 
specified as parameters in the order 
in which you listed them. Finally, it 
will enter the top-level READ-EVAL- 
PRINT loop, issuing a crypnc ">" 
prompt, 

5 At this point, if you did not 
specify "XADVISOR" as a 
parameter in the dialog box, type the 
lollowmg: 

(load "xadvisorlsp") 
and press [Return), Note that here, 
with the load function, you must 
specify the extender in the filename 

Z. Once the XADVISOR.LSP file 
^J has been loaded successfully, 
you are ready to consult a knowledge 
base Two are supplied on the START 
disk: HIRINCRUL and CHESS.RUL 
For demonstration puiposes we'll use 
the fonner because it is smaller, but 
the procedures are the same no mat- 
ter which knowledge base you use. (1 
recommend a ,RUL extender on all 
your knowledge bases for mnemonic 
pui-poses.) 

7 At the next ">" prompt, type 
(prepare "hiring-rul") 

and press (Return), This will cause 
the knowledge base about hiring 
facult}' to be loaded and prepared for 
consultation, (Note: If you receive an 



error message from mistyping and 
end up on a numbered prompt- 
such as 1:> - press Control-G 
until you reach the top-level ">" 
prompt,) 

O We are ready lo ask XADVISOR 
\J for advice! Try entering the fol- 
lomng for starters (at the prompt): 
(advise nil nil 'interactive) 
The progi^am will start to ask }'ou 
questions hke this: 
Is is true that: 

(candidate is one of the top ten in 
his or her field)?> 
Make up some answers (either Yes 
or No) and see how ihe program 
responds. Eventually, you will either 
receive a suggestion like this: 
I advise offering tlie candidate a 
senior faculty position. 
OK 

Or, perhaps this message: 
I cannot give any advice based on 
the given context. 
OK 

The fonner represents the best pos- 
sible advice the program could give 
based on your answers to the ques- 
tions. The latter means that the pro- 
gram couldn't draw any meaningful 
conclusions from your answers, 

^jThe above method is the easiest 
X way to query XADVISOR, and 
the only one needed. It is possible, 
however; to start the program with a 
list of already known facts, so that 
you don't waste time answering 
them, or a "goal" fact-one towards 
which the system should orient its 
deduction. The first nil in the above 
command represents the "known 
facts" parameter, and the second nil 
the goal. A glance at the HIRINCRUL 
hsting will show examples of both 



statements. Newcomers to LISP will 
have difficulty establishing the 
proper sequence of parentheses and 
quotes necessary to properly input 
the parameters, but here is an exam- 
ple of how to input a goal parameter: 
First, setq the list to a label, such as 
"junior"; 

(setq junior '("advise offering the 
candidate a junior faculty po- 
sition")) 

Now, use the label within the query: 



(advise nil junior 'interactive) 



i 



MISCELLANEOUS 

The pretty-printing feature im- 
plemented in the PPRINXLSP file is 
used by typing (pp function-name) 

and pressing [Return), where 
"fun cdon- name" is the name of any 
function not built in. This is in- 
dispensible when debugging your 
programs-just try to read a function^ 
definition rendered by the regular^H 
print function. You can also use ^5H 
PPRINXLSP to pretly-print any hst, 
both within a running program and 
from the top-level loop. 

There is one en'or in some ver- 
sions of the XLISP manual that could 
prove extremely frustrating. In Sec- 
tion 4, "BREAK COMMAND LOOP," 
it is erroneously stated that invoking 
the QUIT function within a break 
loop will return to the next higher ■ 
level, eventually reaching the top 
level loop again. l\\\s is not die cosfcj 
You must press Control-G to do 1 
this, QUIT is not defined and will ™ 
just get you into the next lower break 
loop if you try to use it. ► 
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way, ihey can oiler a range of diagnoses 
with the approximate probabilities that 
each is correct, along with prescribed 
treatments that take this information 
into account. 

• EXPLANATION FACILITIES: Good 
expert systems should be able to not 
only make deductions, but also to ex- 
plain how they were made. Whenever 
the user is asked to provide more data 
to the program, he should be able to ask 
why he is being asked the question so 
that he can follow the system's execu- 
tion and understand how it arrives at its 
conclusions. Indeed, many say that an 
expert system is not truly "expert" if it 
does not know how it makes its de- 
cisions. 

• METALEVEL REASONING: It is 
possible to add control strategy to the 
system's knowledge via "metarules'' or 
rules about the rules. This is becoming 
increasingly necessary for the needs of 
large systems for reasons of efficiency. 
With thousands of rules to choose 
from, what guarantees an uninformed 
inference engine will select those rules 
that are most apphcable to the current 
context (the facts in the database)? 
Wandering about aimlessly, without 
outside guidance, it could waste valua- 
ble time pursuing dead-end reasoning 
paths. 

• LEARNING/KNOWLEDGE 
ACQUISITION: Expert systems can be 
cosdy to maintain and update, so 
researchers have sought to solve the 
problem of machine learning within the 
domain of expert systems. The user 
should be able to interactively inter- 
rogate the knowledge base, and, with 
the program's assistance, modify its 
rules to correct bug? or add new infor- 
mation. Randy Davis's TEIRESIAS addi- 
tion to MYCIN enabled a physician to 
easily use and update the system unat- 
tended. 

• REFINED USER INTERFACE: 
XADVlSOR's interaction with the user is 
limited to yes/no questions, whereas 



the state-of-the-art systems in use today 
can carry on natural-language dialogs 
and allow for graphical input of various 
data. This issue really has as much to 
do with software engineering as with 
expert systems themselves. 

INFERENCE ENGINE 
DESIGN 

There are two basic methods an inler- 
ence engine can use to operate on the 
knowledge and make deductions: goal- 
oriented backward chaining and data- 
driven /orward chaining. In the former 
procedure, the system attempts to estab- 
lish the truth value of a goal fact with 
respect to the given data, while in the 
latter it takes that data and makes all 
possible deductions until it has proven 
one, several, or all goal facts. 

Backward chaining would be used if 
we had a goal in mind that we wanted 
to prove. We would use forward chain- 
ing if we had some data but no idea 
what result it might lead to, or if we 
wanted to find all possible conclusions 
reachable from the data. Note that these 
two control methods will never produce 
mutually inconsistent results: the set of 
facts deducible from the data with a set 
of (context-independent) rules does not 
depend on the order in which those 
rules are used. Both strategies are im- 
plemented m XADVISOR, 

PROGRAM 
DESCRIPTION 

We are at last ready to examine XADVI- 
SOR in depth. The XADVISOR sidebar 
and Disk Instruction page contain star- 
tup descriptions, (Editor's note: Thanks 
to David Betz. author of XLISP, and an 
effective data compression program from 
Quack Computer Company, we have found 
room on the START disk for a complete ver- 
sion 0/ XLISP (v L5b)jrom which you can 
i-un XADVISOR- Interested readers should 
obtain the complete XLISP package with 
documentation and source code from the 
sources listed in the sidebar The remainder 




Al PRODUCTS 
FOR THE ST 

In early June, the following Al prod- 
ucts were available or under develop- 
ment for the ST, 

XLISP: For the ST the only LISP 
actually available at this writing was 
version L5b of XLISP, an excellent 
and well-regarded public-domain in- 
teipreterby David Betz. This, the 
first ST version, was ported co the ST 
by J.R, Bammi in 1985, It is written 
completely in C. and has been im- 
plemented on all the popular 16-bit 
microcomputers as well as under the 
MS-DOS and UNIX operating sys- 
tems, XLISP includes extensions for 
object-oriented programming, but no 
compiler is cunently available. XLISP 
is available in Data Library^ 3 of the 
ATAR116 Forum on CompuSen-'e, as 
well as from user groups and Antic's 
pubUc domain library. Be sure to get 
all the documentation files, and the 
C source code if you're interested. 

CAMBRIDGE LISP: Metacomco 
is porting their Ami^LISP package to 
the ST, and it should be available 
soon through The Catalog, The Cam- 
bridge dialect is somewhat different 
from Common LISP, the emerging 
standard, but it has a good reputa- 
tion among those who use it exten- 
sively 

Metacomco 

5353E Scoffs Valley Drive 

Scoffs Valley, CA 95066 

(408) 438-7201 

(Expecfed available fhrough The 

Catalog; no price sef) 

CIRCLE 227 ON READER SERVICE CARD 
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PERSONAL PROLOG: This 

long-awaited PROLOG environment 
for the ST from Optimized Systems 
Software should also be completed 
by now. According Co OSS, it will use 
a full GEM multiwindow environ- 
ment, with incremental compilation 
and interactive program develop- 
ment and testing. PROLOG programs 
will have access to TOS services, in- 
cluding GEM. 

Optimized Systems Software, Inc. 

1221B Kentwood Avenue 

San Jose, CA 95129 

(408) 446-3099 

$74.95 

CIRCLE 228 ON READER SERVICE CARD 

EXPERT OPINION: This hrst 
expert systems shell for the ST was 
developed by MindSoft of France us- 
ing Modula-2, and is available 
through The Catalog, It too makes 
use of the GEM interface. 1 include it 
here because it is really just a pro- 
gramming language, or at least an AI 
tool, that is specialized for producing 
expert systems. Expert Opinion is as 
powerful as most of the MS-DOS 
paclcages currenriy available, and is 
especially suitable for experimenting 
and prototyping larger systems. 

The Catalog 

524 Second Street 

San Francisco, CA 94107 

(800) 443-0100 Ext. 133 

$99.95 

CIRCLE 229 ON READER SERVICE CARD 



oj this article is an analysis of the 
XADVISOR code and assumes some knowl- 
edge ojLlSP. We reaiizcjcw readers will 
know this language and recon^mend they 
pick up any of the LISP books listed in the 
Reference section. We have found XLISP to 
work with most of the example code found 
in standard LISP hooks.) 

Looking at the XADVISOR code, we 
find that the listing can be divided into 
four parts: the top level and initializa- 
non functions (ADVISE, PREPARE. IF), 
the backward chaining module 
(BACKWARDS, TRY-ALL, 
BACKWARDS-AUX). the fonvard cham- 
ing module (FORWARDS), and the util- 
ity functions used by them (ASSERT, 
CONDITIONS, ASK-USER, TRUE. 
TERMINAL). The entire program 
amounts to these twelve definitions. Be- 
fore we look at them, let's examine the 
main global variables used by the infer- 
ence engine: 

RULEBASE is the knowledge base of 
the system. It is a list of the production 
rules in the order that they were read 
from disk. Each rule is represented itself 
as a list whose CAR is a hst of the an- 
tecedent conditions and whose CADR 
is a single consequent action. Individual 
conditions and actions (facts) are 
represented as lists, each containing one 
string literal. 

PROVEN and DISPROVEN are the 
database of the system. They are simply 
lists that contain tacts that have estab- 
lished truth values. 
Now, on to the program's functions: 

ADVISE is a (ront-end function used 
to query the program on a knowledge 
base that has already been loaded into 
memory. Its formal parameter list con- 
tains the keyword &rREST, which binds 
the next atom to a list containing all of 
the remaining arguments to the func- 
tion. Here, we use this to allow the user 
to pass one or more option descriptors, 
which are collected in OPTIONS for 
later use. Currendy, only INTERACTIVE 
IS supported, but others could be added 



without changing the form ol the 
ADVISE call. 

Next we have a SETQ with more 
than two arguments; it simply binds 
each atom to the succeding value. Ini- 
tially, we use l-FLAG to indicate 
whether the interactive option has been 
selected, we set the list of PROVEN facts 
to the CONTEXT passed by the user 
and we set the list of DISPROVEN facts 
to be NIL. 

The rest of the function is just a 
COND expression that branches off to 
either the backward or forward chaining 
mechanism depending on the argu- 
ments to ADVISE. If there was no goal 
specified but the user did pass a list oi 
known facts, he or she must vrant to 
forward chain from those facts. If there 
was no goal and no context, he or she 
must want to find the best solution 
given data that will later be entered in- 
teractively. II there was a goal, he or she 
must want to backward chain from it. 

The rest of ADVISE just sets up some 
nice looking output. PRINC and TERPRI 
are standard functions that print out 
objects and issue carriage returns. The 
only other form here that we haven't 
seen before is LET, Without going into 
detail on its syntax, 1 can say that LET is 
a powerful construct that sets up local 
environments, or temporary bindings 
that only apply within the LET expres- 
sion and disappear once it is exited, 

PREPARE must be called by the user 
before the first call to advise ADVISE. 
Given a valid GEMDOS pathname, en- 
closed in double quotation marks, 
PREPARE passes it on to LOAD to read 
in the knowledge base from a disk file. 
For our purposes, please accept the ac- 
tions of both PREPARE and IF (another 
special construct known as a macro) as 
magic. They are rather kludgey anyhow, 
and you can probably figure them out 
with the help of a LISP book, 

BACKWARDS is the real meat of the 
program This function takes any fact, 
presumably a consequent action in one ► 
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Al APPRENTICE... 

or more rules of the knowledge base, 
and attempts to prove its truth. It does 
this in several ways. First, if ACTION is 
bound to NIL, it calls TRY-ALL (see be- 
low). If ACTION has already been 
proven, we return T If it has been dis- 
proven, we return NIL. Otherwise, we 
bind CONDITION-SETS to a list con- 
taining all the sets of conditions that 
would satisfy the ACTION. If there are 
none, meaning there are no rules that 
mention the ACTION as a consequent 
action, we try to ask the user whether it 
is true or not. This is the only place 
where user interaction occurs, and it 
only happens if the user explicitly re- 
quested it in the call to ADVISE. (If the 
user felt he had provided all the facts in 
the CONTEXT variable, he could oper- 
ate in a sort of "batch mode," just wait- 
ing for the system's advice.) On the 
other hand, if there are conditions on 
the ACTION, we call BACKWARDS-AUX 
to deal with them. 

TRY-ALL, given a list of RULES-LEFT 
(to try), will try to backward chain from 
every "terminal" goal, that is, every goal 
that is mentioned as a consequent ac- 
tion in one or more rules in the knowl- 
edge base, until it succeeds in proving 
one of them. It will then return that ac- 
tion, but it will return an inconclusive 
message if it still fails after recursing 
through the entire RULEBASE list. 

BACKWARDS-AUX, given an 
ACTION and a list of the set's ante- 
cedents of rules that mention it as the 
consequent, will recurse through that 
list attempting to find a set of condi- 
tions that can be satisfied by ASSERT, If 
a call to ASSERT returns non-NIL, we 
can add the ACTION ro the set of 
PROVEN facts and return T. Otherwise, 
if we run out of CONDITION-SETS, we 
return NIL as we are unable to establish 
the truth of the ACTION, 

FORWARDS is a huge function that 
forward chains from the facts contained 
m PROVEN to deduce more facts, even- 
tually either deducmg goals or mnning 



out of things to deduce. When called 
from ADVISE, it is initially passed the 
rulebase reversed (using the built-in 
function REVERSE) so that the lowest 
priority rules appear first. It operates by 
recursing through the rules in this order, 
attempdng to find rules whose conse- 
quent actions are not already proven 
but whose antecedent conditions all are. 
When this happens, it has deduced a 
new fact, so it adds that action to the 
PROVEN list and begins a^in at the 
end of the rulebase. When it deduces a 
goal, it adds it to the hst ANSWER- 
STREAM which will contain all the 
goals deduced from the given set of 
PROVEN facts. If it ever runs through 
the entire rulebase without a single rule 
firing, then clearly nothing more can be 
deduced. In this case, if ANSWER- 
STREAM is non-empty we return it, 
otherwise we return the inconclusive 
message. 

By now 1 hope you have noticed 
that, despite all the parentheses and the 
convention against comments embed- 
ded within functions, LISP programs are 
relahvely easy to read. This is due to 
lisp's modular structure, long symbolic 
atom print names, and the self- 
documenting nature of its function 
names. 

The remaining five functions of 
XADVISOR offer good examples of 
recursive list manipuladon and I/O. In 
ASK-USER we print a question about 
the truth value of a particular ACTION 
and then call on built-in function READ 
to obtain the answer READ is actually 
the same reader we met early on at the 
beginning of LISP's top level 
READ-EVAL-PRINT loop. As shown 
here, it can be called any time, and will 
return a symbolic expression obtained 
from standard input. Of course, EVAL 
and PRINT are also available to user 
programs, though they were not direcdy 
necessary to this one. 

In fact, in my experience, XADVISOR 
is an excellent example of how much 



can be accomplished with a very few 
LISP primitives. We didn't use any fancy 
object-oriented programming tech- 
niques, destructive list modification, 
anonymous funcnons, property hsts, or 
other esoteric powerful features of the 
language. XADVISOR was originally 
written in Franz LISP a dialect that runs 
primarily under the UNIX 4.2BSD oper- 
ating system on VAX minicomputers. It 
required changes to only eight lines of 
the source code to port it over to XLISP 
running under TOS on the Atari ST. 

To help you get started experiment- 
ing with XADVISOR and XLISP, I have 
included two sample knowledge bases 
on the disk: HIRING.RUL and 
CHESS.RUL. The former, containing 15 
rules, makes a somewhat whimsical at- 
tempt to advise a Computer Science 
department chairman on hiring candi- 
dates for faculty positions. The latter, 
with 57 rules for recommending plans 
in chess positions, taxes the abilities of 
a limited production rule interpreter 
like XADVISOR, With some easy exten- 
sions and major additions. XADVISOR 
could be suited to such a complex 
problem domain. 

CONCLUDING 
THOUGHTS 

1 hope this article has raised your inter- 
est in artificial intelligence, expert sys- 
tems, and LISP programming. We had a 
lot of ground to cover, but you can catch 
up and learn far more by reading any of 
the books listed below. With the ST, you 
have a machine that is definitely capa- 
ble of serious AI work. One company is 
marketing the Macintosh as an Al work- 
station for LISP and expert systems, so 
why not the faster; higher-resolution ST? 

The most difficult tasks for human 
bein^, such as mukiplying ten-digii 
numbers or remembering detailed tacts, 
are simple even for tiny computers. But 
the simplest second-nature human be- 
havior, such as reading, speech, and vi- 
sion, is extremely difficult lor today's 
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most powerful computers. These 
differences-between the machine and 
the mind -make the challenge oi" 
artificial intelligence all the more in- 
triguing! ■ 

REFERENCE: 

For an entertainmg introduction to 
artificial intelligence, very suitable for 
the non-technical reader: 

• The Cognitive Computer: On Language, 
Learning, and Artificial Intelligence, by 
R.C Schank with P Childers, 
Addison-Wesley, Reading, MA 

The following are general texts on 
artificial intelligence Although they are 
rather technical, confident programmers 
should not have much difficulty under- 
standing them: 

• Introduction to Artificial Intelligence, by 
E. Chamiak and D. McDermott, 



Addison -Wesley Reading, MA 

• Artificial Intelligence (second edition). 
by PH. Winston, Addison-Wesley, 
Reading, MA 

There has been a proliferation of books 
on expert systems recently Here are 
some with which 1 am familiar: 

• Building Expert Systems, by F, Hayes- 
Roth, D.B. Lenat. and D.A. Waterman, 
Addison-Wesley, Reading, MA 

• Introduction to Expert Systems, by P 
Jackson, Addison-Wesley, Reading, 
MA 

• A Guide to Expert Systems, by D. 
Waterman, Addison-Wesley Reading, 
MA 

The following all offer excellent coverage 
of LISP programming, often relating the 
language directly to Al problems and 
their solutions: 



• Artificial Intelligence Programming, by 
E. Charniak, C. Riesbeck, and D. 
McDemiort, Lawrence Edbaum As- 
sociates. Hillsdale, NJ 

• Common LISP: The Language, by G.L 
Steele, Digital Press, Budington, MA 

• LlSPcraJt, by R. Wilensky WW, Nor- 
ton, New York, NY 

• LISP (second edition), hy P-H Winston 
and B K.P Horn, Addison-Wesley 
Reading, MA 

Finally, a few good books on PROLOG 
and logic programming: 

• Programming in Prolog (second edition), 
by WF Clocksin and C.S. Mellish, 
Springe r-Vedag, Bedin, Germany 

• Introduction to Lo^c Programming, by 
C.J. Hogger, Academic Press, London 

• Prolog/or Programmers, by E Kluzniak 
and S. Szpakowicz, withJ.S. Bien, 
Academic Press, London, England 
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SEVEN 

WORD 
PROCESSORS 

EXAMINED 

by Ian Chadwick 



hich word processor should you buy? START 
examines seven ST word processors now on the 
market and looks at future products. An extensive 
chart compares over 90 common features. 




ore people use personal 
i computers for word 
1 processing than for any 
other purpose This is hardly surprising: 
even rudimentary word-processing soft- 
ware makes typewriters look paleolithic 
by comparison. Perhaps this marvelous 
new way of writing is the main benefit 
you hope to get from your ST computer 
but even if it is not, selecting a word- 
processing program is certain to be one 
of your early software decisions. 

What do you need to know to make 
an intelligent decision about getting a 
word processor? It depends on your in- 
tended use. If you are a professional 
writer, the word processor will be a tool 



far more important than any typewriter 
Plan to spend some bucks on it. Care- 
fully consider the requirements your 
marketplace imposes on your output 
(including efficiency), and shop for fea- 
tures you will need. If you are a begin- 
ner, an inexpensive or free program may 
be all you'll ever need. 

ST software is still in its infancy, and 
as a result there are no word processors 
that fully use the potential of the ma- 
chine Nonetheless, the word processors 
now available should meet the needs of 
many of you, and several new proces- 
sors will enter the market in the coming 
year 



FREEWARE 

Two free word processors are available 
that should do the job until you have a 
better idea of what you really want and 
need: 1ST Word and ST Writer Both are 
from Atari, but are quite different from 
one another 

1ST Word comes Iree with the pur- 
chase of either the 520 or 1040 ST A 
GEM-based program, it uses the mouse 
on the familiar Desktop, pull-down 
menus, windows, and any desk acces- 
sories the writer specifies. Useful for 
modest writing projects that don't de- 
mand much formatting, it is easy to 
iearn and use for the beginner. Unfor- 
tunately 1ST Word lacks headers, page 
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numbering, file merge, and common 
printer options that most users want for 
any serious or lengthy writing. It is a bit 
slow for the practiced typist, and has no 
global reformatting capability, making 
this a tedious chore in a large 
document. 

ST Writer, on the other hand, is a 
capable and mature outgrowth oi the 
successful AtariWriter for 8-bit Atari's. It 
is good enough for moderately demand- 
ing work, but lacks the document- 
oriented features necessary for technical 
writing and other major undertaking 
such as scripts and books. It is not 
GEM-based, however it is free Atari 
supplies copies to all dealers and regis- 
tered Atari users groups. They may le- 
gilly copy it for you. It also appears on 
CompuServe as downloadable software 
in S1G*ATARI, and on Atari's own free 
BBS (408) 745-5308. 

NOW SHOWING 

Five commercial word processors are 
available at this writing: Haba Writer, 
FinalWord, Let's Write, Regent Word 
and TextPro, The chart accompanying 
this article details the features of these 
five programs, plus the two free ones. 
You may find one of them suitable for 
you now. 

FinalWord, from Mark of the Uni- 
com, is the most complete and 
expensive- $145, Powerful and sophisti- 
cated, but not GEM-based, it was 
designed to emulate Perfect Writer, a 
very popular program in the IBM envi- 
ronment. Unfortunately, it suffered in 
the translation, fails to exploit the ST's 
memory, and has several bugs (see re- 
view, "The Final Word" Antic, April, 
1986). This is a document processor, 
i.e., suitable for big projects, and has 
most of the features a professional 
writer of complexly formatted material 
would need. 

Let's Write, from Mark Williams 
Company sells for $79.95. This tool is a 



collection of programs that perform the 
range of tasks required of a word 
processor, however they are not 
integrated as state-of-the-art word 
processors are. Not GEM-based, the 
main program is MicroEMACS, a 



Selecting 

a word-processing 

program is certain to 

be one of your 

early software 

decisions. 



command-driven text editor derived 
[rom the mainlrame and academic com- 
puter worlds. It is powerful but com- 
plex, and definitely not easy to use. 
Supporting programs format the text, 
control the printer, check spelling, and 
communicate online. It doesn't use the 
mouse, the Desktop, or even help- 
screens, but once you learn it from its 
large, indexed manual, it is powerful and 
reliable. 

Regent Word, from Regent Software, 
is designed for the ST, but is also not 
GEM-based. The stand-alone word 
processor costs $49,95, but recently the 
company combined it with Regent Spell 
into a package called Regent Pak, that 
sells for the same price. Be sure to ask 
your dealer for the Pak when you shop 
for Regent Word. Regent Word II, 100 
percent GEM-based, including built-in 
spelling checker, was in development at 
this writing, and may now be available 
for about $100, In some ways Regent 
Word is similar to ST writer: command- 
driven, one file at a time, full RAM avail- 



able, headers, footers and page num- 
bers, etc, (see Chart for comparison), 
but its command set and output func- 
tions are not as full as a professional 
needs and it lacks some niceties I've 
learned to appreciate, such as a cursor 
jump to the beginning or end of a line, 
multiline headers, and search-and- 
replace in reverse. These are not fatal 
flaws, but I'd like to see Regent Word II 
before buying this package 

Haba Writer, $74.95 from Haba Sys- 
tems, is a GEM-based program and very 
easy to learn and use, but make sure 
you get version 1.D2 or later because 
earlier versions were buggy. As of Au- 
gust, 1986, Haba Writer will have a 
spelling checker and mail-merge func- 
tion. It can keep seven separate files 
available for work in RAM at the same 
time and has a WYSIWYG display. 
WYSIWYG means "What You See Is 
What You Get," that is, the screen is for- 
matted identically to your printer out- 
put. As a part of the GEM worid, Haba 
Writer can enjoy the benefits of RAM- 
resident desk accessories such as 
Michtron's Alt, BI's Thunder, or even the 
Reversi accessor}' included on your 
START disk. 

TextPro is a German word processor 
reworked for English and sold in the 
U.S. by Abacus Software for $49,95. Just 
available at presstime, information from 
the company describes it as a "profes- 
sional quality word processor^' It is 
GEM-based, with optional keyboard 
commands for menu items. Users can 
define the function keys-make their 
own macros -and use TextPro as a text 
editor for the C language. Eight printer 
drivers come with it, including one that 
prints sideways on Epson printers, 

COMING SOON 

On the horizon are several products ex- 
pected by Christmas or early spring. 
Hippo Word (est, $90 from Hippopota- 
mus Software) will support a laser ► 
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printer, allowing SI" users to enter the 
desktop publishing arena. Two new 
GEM word processors- 1ST Word Plus 
(from Atari), and PaperClip Elite (est, 
$100 from Batteries Included) -will read 
graphic files into text and print them 
out within your document, HomeText, 
from Batteries Included, will permit the 
writer to reduce complex procedures 
into a single keystroke (macros) and 
will have menus that pop-up from the 
bottom of the screen as well as pull- 
down from the top menu bar. 

The two most talked-about programs 
under development are Microsoft Write, 
and Word Perfect, Microsoft Write, an 
implementarion of Microsoft's success- 
ful Macintosh program, Word, will be 
sold under license by Atari for approxi- 
mately $200. Word Perfect, from Word 
Perfect, Inc, will be similar to one of the 
best-selling and arguably the most 
powerful word-processing programs in 
the IBM environment. Word Perfect, Inc, 
says it will cost around $500, 

SPELLING CHECKERS 

Spelling checkers are becoming essen- 
tial for any serious writer who uses a 
word processor. Human proofing is still 
needed to find errors the checker will 
miss, e,g, "there" for "their'" but even 
good spellers use these programs as 
proofreaders, to find typos and other 
errors. 

At this writing there are three stand- 
alone speUing checkers available for the 
ST: Hippo Spell (Hippopotamus Soft- 
ware, $39,95), Regent Spell (Regent Soft- 
ware, $49.95), and Thunder (Batteries 
Included, $39,95), The first two are pro- 
grams that work on a document after it 
has been written and saved- Thunder 
can also work while you type, This is a 
new feature, successful in the IBM PC 
world and appearing also on expensive 
electronic typewriters. Time will tell if it 
is a real advantage or only a gimmicky 
annoyance. 



A basic spelling checker compares 
each word in your document to the 
words in its own "dictionary" and alerts 
you to exceptions. These exceprions 
may be correct words that you can ac- 
cept, or errors you can change. Regent 
Spell and Hippo Spell are basic spellers 
with 30,000 word dicdonaries. Both of 
these programs allow you to add your 
own words to the dictionaries. 



Regent 
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Thunder Is more advanced. In real- 
dme mode, it alerts you as you type an 
unrecognized word, and suggests alter- 
native words you may have meant. It 
will "leam" your most common errors 
(e,g, receive for recieve) and auiomad- 
cally correct them when encountered. It 
has global correction, handy for making 
a systemanc change in a document, and 
can expand your favorite abbreviations. 
Thunder also analyzes your document 
statistically, counting everything from 
characters to paragraphs, and renders 
several indexes of readability, 

THE CHART 

The Word Processor Comparison Chart 
(on page 36) lists many features that 
are available on word processors. Each 
feature can be useful in some situanons, 
but not others; you must decide for 
yourself, based on your probable use. 



CONCLUSION 

If you think you need or want a word 
processor, you have several options 
available now, or if you want to wait, 
several important new products are ex- 
pected within six months. Two major 
types exist: GEM and nonGEM. If you 
like working on the Desktop with icons 
and the mouse, stick with GEM. Non- 
GEM programs will require learning 
commands and procedures that can be 
very comphcated but may be worth- 
while if you need special powers or fea- 
tures. If you already know a word 
processor such as EMACS or Perfect 
Writer, you might shorten your learning 
curve by getting a lookalike program. 
Some word processors have their own 
speUing checker, a value and con- 
venience you should consider Begin- 
ners should start with a program that is 
easy to use, because complicated and 
poody documented word processors 
can easily become a nightmare. Profes- 
sional writers need to leam about word 
processing by experimentation and in- 
quiry in order to evaluate the suitability 
of programs for themselves; however, 
they should consider the most capable 
products available, ■ 

LIST OF 
MANUFACTURERS: 

• Abacus Software 

2201 Kalamazoo S.E. 

P.O.Box 7211 

Grand Rapids, Ml 49510 

(616)241-5510 

CIRCLE 208 ON READER SERVICE CARD 

" Batteries Included 

30 Mural Street, Unit 9 

Richmond Hill 

Ontario L4B 1B5 Canada 

(416)881-9941 

CIRCLE 209 ON READER SERVICE CARD 
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The Price War Is Over 
We Won! 

We Will Beat Any Prlce...Anywhere. 



Atari ST 
Hardware 

Atari 520STRGe S785 

Atari 520ST Mono S645 

Atari SF354 $149 

Atari SF314 S208 

Atari SM124 $165 

Atori SC1224 $335 

Supra Hard Disk . . . Cell 

Printers 

Panasonic Call 

Star Micfonics Call 

Citizen Call 

Modems 

Avolex120D S?9,0D 

QMI1200SI $129 00 

Atari XM30i $35.99 

Supra MPP1000E . . Coll 

Specials 



AvQlex 120D 

PR Conn. Amodem . 

Atoriwriler Plus . 

Avatex1200. 

Sakata SCIOO . . 

Teknika Mj-10 . . .. 

Teknika MJ-22. ,, 

Habowriter 

Hippo C 

Hippo EpJom Burner. 
Color Printer 



$149.00 
S24 95 
$79.00 
$137 00 
$178.00 
..Call 
. $25.00 
.$25.00 
. $99.99 
. Call 



Avatex 1200 
^79.00 




Hayes Compatible! 

Everyday Low 

Price! 



Atari ST 
Software 

Borrowed Time $29.95 

Rogue $24.95 

Final Word $85.99 

Haba Software .. .Cheap 

Hacker $27.95 

H 8( DBase $65.00 

H 8iDFonii $35.00 

H &D Toolbox $25.00 

PC Interoomm $74.95 

Personal Diskit Coll 

Sundog $24.95 

VIP Pfolessional Call 

Silenl Sen/ice $24.00 

Flight Simulator Call 

lyicroC Shell $33,00 

Mindsliadow $29.95 

Print Master . .$24 95 

P.M. Art Gallery $19.95 

Easy Drow $97.00 

Graptiic Artist ... , Call 

Music Studio .. ..$36,00 

2Key Accounting $32.99 

Home Planetorium. . . . $19.75 

Joust $19.75 

CPM Emulator $32 99 

Tempte of Apshoi 

Trilogy $24,95 

Metocomco Pascal . . $69,95 

Lattice C $98,00 

Andra Call 

UCSD PascGl Call 

Regent Spell Call 

Regent Word $35.00 

Regent Word II Cdll 

Regent Base Cdll 

Meto 68000 Asm $59.95 

Broftocas $29,95 

Degas $23,95 

Personal Pascal . . ,$48.00 

ST Talk $11,00 

Zoomracks $48,99 

Modula-2 $49,95 

Personal Prolog Call 

Kings Quest II $32.00 

TosCtiips $24.95 

Universe II $49.00 

ST Copy $18,99 

Typing Tutor $16,75 

Spidermon $12,95 

Mouse Mat $7,49 

Ultima II $37.50 



Atari 


8- 


Bit 


Hardware 


Atori130X£... 




. $118.95 


Atari 65XE . 




.... Call 


Atari 1050 .. 




...$124.50 


Indus GT 




. . Coll 


Atari 1027 .... 




... $79.00 



Accessories 

us Doubter. ... $48 00 

RomboXL $33.00 

R-Time Cart $48.00 

Bonus SS DD 5.25 $6.50 

Bonus DS DD 5.25 . $7.00 
PoperlOOO Stieels . . $11.00 
Paper 2500 Sheets $22.00 

Maxell 3.5 $1750 

Xetec. $39.95 

Logo Manuals . . $13 50 



Interfaces 

P.R Connection . $57.00 

Supta Microprint $29.00 

Supra 1150 . . ..$39.00 
ST Modem Cable... .$12 00 
Supra Microstuffer. . .$59.00 
U-Prinf. . . . $48.00 

Apelace $35,00 

Atari 850 .$109.00 

ST Printer Coble .. . $^2.00 



Atari XiVISOl 
l\/lodem 
^35.99 



*^K»._.- 



Atari 8-Bit 
Software 

Action! $46,00 

Basic XE $46.00 

Basic XL $36.00 

Battalion Command $24,95 
Battle of Antietam. .,.$32.00 

B Graph $24.95 

Broadsides $24.95 

Computer Baseball . . $24.95 

Computer Q6 $24.95 

Conflict in Nam $24.95 

Crusade in Europe . , . $24,95 

Silent Sutler $19 99 

Gemstone Warrior. ..$22,00 
War in Russia . . $48.00 
Dec. in 11^,6 Desert .$24,95 
Kennedy Appraacti $19 50 

Solo Flight $19.50 

Learning Phone. . . . Coll 
Syncalc130XE . . .$29.95 

Paperclip $34.00 

Mac 65 $46.00 

Print Shop $27,50 

Korateko $18,50 

Lode Runner $22,00 

Atoriwriler Plus $24,95 

Panzer Grenodier , . . , $34.00 

Hacker $15.75 

Space Shuttte $15.75 

Mindstiadow $15,75 

Great Am. Rd, Roe, , ,,$15,75 

F-15 Strike Eagle $19,95 

Silenl Service $19,50 

SyntileiaOXE $29.95 

Poge Designer $19.00 

HomePok $30.00 

OSS Toolkits $19.50 

Printshop Lib. 1.'2.'3 ...,$17.00 

Chmp, Lode Run $18.50 

Ultima IV $39,00 

Sparta Das CS $26,00 

Home File Manager, , . $7,99 

Music Painter $7.99 

Star Raiders $7.99 



Black fttch Systems 



987-2300 (Toll Call) 

write 



ORDERS ONLY: S^ Call TOLL FREE 1-800-ATARI-02 or 301-< 

For technical information or order inquiries, coll 301-987-0019, oi 
Black Patch Systems, P.O. Box 501, Arnold. MD 21012 

HOW TO ORDER: CASHIER CHECK, fLlOr^EV ORDER. MASTERCARD" OR VISA'(ADD -Co FOR CHARGE CARDS) . MO PERSONAL CHECKS . NO C O D. s . 

SHIPPED UPS ALL PRICES SUBJECT TO CHANGE WITHOUT NOTICE 

SHIPPING; ADO S3.00 ON ALL ORDERS UNDER S100.00 ADD S5 00 ON ALL ORDERS OVER SI 00 00 ACTUAL FREIGHT CHARGED ON fulULTIPLE ORDERS. 

INTERNATIONAL: ACTUAL FREIGHT CHARGED ON ALL ORDERS OUTSIDE THE CONTINENTAL UNITED STATES INCLUDING A. P.O. 

POLICIES: NO RETURNS WITHOUT A HETUHN AUTHORIZATION NO RETURNS UNLESS DEFECTIVE. ALL DEFECTIVES WILL BE EXCHANGED . 

NO EXCEPTIONS CALL OR WRITE FOR FREE CATALOG ■ DEALER INQUIRIES INVITED 

CIRCLE 009 ON READER SERVICE CARD 



WORD PROCESSORS. 



CompuServe Information Services 

P.O. Box 20212 

5000 Arlington Center Blvd. 

Columbus, OH 43220 

(800) 848-8199 

CIRCLE 210 ON READER SERVICE CARD 

Haba Systems 

6711 Valjean Ave. 

Van Nuys, CA 91406 

(818) 989-5822 

CIRCLE 211 ON READER SERVICE CARD 

Hippopotamus Software 

985 University Avenue, Suite 12 
Los Gatos, CA 95030 



(408)395-3190 

CIRCLE 212 ON READER SERVICE CARD 

Mark of the Unicorn 

222 Third Street 

Cambridge, MA 02142 

(617)576-2760 

CIRCLE 213 ON READER SERVICE CARD 

Mark Williams Company 

1430 W. Wrightwood Ave 

Chicago, IL 60614 

(312)472-6659 

CIRCLE 214 ON READER SERVICE CARD 

Microsoft Corp. 

16011 NE 36th Way 



Box 97017 

Redmond, WA 98073-9717 

(206) 882-8080 

CIRCLE 215 ON READER SERVICE CARD 

Regent Software 

7131 Owensmouth-Suite 45A 

Canoga Park, CA 91303 

(818) 882-2800 

CIRCLE 216 ON READER SERVICE CARD 

Word Perfect Corp. 

(was Satellite Software, Inc.) 

288 West Center 

Orem, Utah, 84057 

(801) 227-4299 

CIRCLE 217 ON READER SERVICE CARD 



START CHART 

ST WORD PROCESSORS 



ST 1ST liaba Final Regent Let's 

Writer Word Writer Word Word Write 



Text 
Pro 



Original system 


800 


ST 


ST 


IBM 


ST 


Mainh 


ST 


Feature: 


GEM based 


no 


yes 


yes 


no 


no 


no 


yes 


Protected disk 'flHH^IR' 


no 


no 


yes 


yes 


yes 


no 


yes 


Handles folders well 


yes 


yes 


yes 


no 


no 


no 


yes 


Handles hard drive well 


yes 


yes 


yes 


no 


no 


yes 


yes 


Uses all free IMM for text 


ya 


yes 


yes 


no 


yes 


yes 


yes 


Text file size limitations 


RAM 


RAM 


RAM 


48K 


[lAM 


RAM 


RAM 


Number of files in memory 


1 


4 


7 


10 


1 


8 


1 


■ Help screens 


no 


yes 


no 


yes 


yes 


no 


no 


Search for bare carriage return 


yes 


no 


no 


\es 


no 


no 


yes 


-: Saves ASCII file 


no 


yes 


yes 


yes* 


yes 


yes 


yes 


Saves unformatted ASCII hie 


no 


no 


yes 


yes 


no 


yes 


yes 


Auto secdon numbering 


yes 


no 


no 


yes 


no 


yes 


no 


Auto indexing 


no 


no 


no 


yes 


no 


no 


yes 


Transpose characters 


no 


no 


yes 


yes 


no 


yes 


no 


Transpose words 


no 


no 


no 


yes 


no 


no 


nd 


Undo last delete (not cut) 


yes 


no 


no 


yes 


yes 


yes 


no 


Auto header/footer 


yes 


no 


no 


\vs 


yes 


\'es 


yes 


; Vary headers/ footers each page 


yes 


no 


no 


yes 


no 


yes 


yes 


Multiline auto header/footer 


2 


no 


no 


)'CS 


no 


\'es 


)'es 


Format disk 


yes 


no 


no 


no 


no 


no 


no 


Merge [lies from disk 


>'es 


no 


no 


)-es 


yes 


yes 


yes 


Delete file from disk 


yes 


yes 


no 


no 


no 


no 


yes 


Page wait eominand 


yes 


no 


no 


yes 


yes 


yes 


yes 
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ST 1ST Haba Final Regent Let's Text 

Writer Word Writer Word Word Write Pro 























Set starting page number ^|MH|hh««hh| 


UK; y^^ 


no 


no 


yes 


yes 


yes 


yes ij 




Hide format symbols 


no 


n/a 


;,'es 


no 


no 


no 


yes 






^^^K^' 


no 


no 


yes 


no 


yes 


no 




Uses mouse 


no 


\'es 


\'es 


no 


no 


no 


yes 






I^B;.' y^^ 


no 


no 


yes 


yes 


yes 


yes j 




Uses lunction keys 


)^es 


yes 


yes 


yes 


yes 


no 


yes 




User-definable functiorT^^^^HIHHI^^I 


1^^^-' 


no 


no 


no 


no 


no 


yes i 




Display 80 cols on screen 


yes 


no 


no 


yes 


\'es 


)'es 


no 




Edit > 80 columns/screen -^^^^^^^^^^^1 


^^^^^ 


yes 


yes 


no 


no 


no 


yes J 




lidit > 24 lines/' monochi-ome 


)'L'S 


no 


no 


no 


no 


yes 


no 




Change display color . ^^^^^^^^^Hj 


HBJK:: some 


yes 


yes 


no 


no 


no 


yes { 




Variable line spacing 


yes 


yes 


no 


yes 


\'es 


yes 


yes 




Variable paragraph formats -l^^^^^^^^^^H 


j^HI'' yes 


yes 


yes 


yes 


yes 


yes 


yes 1 




Au;o indentation/ variable 


yes 


no 


yes 


yes 


no 


yes 


)'CS 




Upper/lowercase toggle ^J^^^^^^^^^^H 


^^B'^ yes 


no 


no 


yes 


no 


yes 


no \ 




Double column editing 


no 


no 


no 


no 


no 


no 


no 




Math functions internal ^^Hj^^^^^^^l 


^^n^^ 


no 


no 


no 


no 


no 


no I 




Save custom prmt formats 


>'es 


no 


yes 


yes 


no 


yes 


yes 


f, 


Muldple fonts or typefaces J^^HHIHBMHj 


^^^^K- 


yes 


yes 


no 


no 


no 


yes "J 




Word wrap on/oFf to^le 


no 


yes 


no 


yes 


no 


no 


yes 




Switch disks while editing ".^^^^^HHHHj 


m' 


yes 


some 


no 


yes 


yes 


yes 1 




Sub/sLiperscript commands 


yes 


yes 


yes 


yes 


yes 


no 


yes 




What you see is what you g^^H^^^^^^^H 


^^^^fe. 


yes 


yes 


no 


no 


no 


no ."i; 




Auio reformat existing text 


yes 


no 


no 


yes 


)'CS 


yes 


yes 




Global reformat ^^IH^^^^^^I 


HB^'. y^^ 


no 


yes 


no 


yes 


yes 


yes ; 




On screen justification 


no 


yes 


yes 


no 


no 


no 


no 




On screen text alignment '^j^^^HJIH 


Ijfjjlljj^-' 


yes 


yes 


no 


no 


no 


no j 




Insert/replace mode toggle 


no 


yes 


yes 


\'es 


no 


no 


yes 


1^ 


' fllHHjj^^l 


^^^^' 


no 


yes 


no 


no 


no 


yes "i 




i^age/screen up & down 


yes 


yes 


yes 


yes 


yes 


yes 


yes 


i 


Cursor to line end/start '^||H^HHII1H 


^H^ y^^ 


no 


yes 


yes 


no 


yes 


yes i 




Display full character set 


no 


yes 


no 


no 


no 


no 


no 




Display internadonal character set ''^H^^^^l 


^^^^p- 


yes 


yes 


no 


no 


no 


yes 1 




Display control characters 


^^^, >'" 


yes 


no 


yes 


yes 


no 


yes 




Search/replace non-ASCII character sec "iHI 


Hiiiiw'' 


no 


yes 


no 


no 


no 


yes ^ 




Word count 


no 


no 


no 


no 


yes 


yes 


no 






^^^■^' 


no 


no 


yes 


no 


no 


yes 'i 




Line count 


^^^HC ^'^■'^ 


no 


yes 


yes 


no 


yes 


yes 




Available RAM count "^^^^hH^^^^^^^I 


I^Hi' 


no 


no 


no 


yes 


yes 


yes ^ 




Search/replace in reverse 


^^^» y-^s 


yes 


yes 


yes 


no 


yes 


no 




Ignore in search '^^^^^^^H^H 


H^^K' 


yes 


no 


yes 


no 


yes 


no h 




Ai.;iosavc 


no 


no 


no 


yes 


no 


)'es 


no 






^^^^' no 


yes 


yes 


no 


no 


no 


yes J 




Shows current page number 


no 


some 


yes 


no 


no 


no 


yes 
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PROGRAM: 



SI 1ST Haba rinal Regcnl Lcl's Text 

Writer Word Writer Word Word Write Fro 





















t 


Can read other word-processor files ^I^H 


Bft >'^' 


yes. 


some 


yes 


some 


ACSII 


yes 




Can read ASCII non word-processor files 


yes 


)'es 


yc> 


ves 


no 


\'es 


>'es 


l. 


Include graphics with ^^^^'W^^^K^^K^^^^^M 


WM "^^ 


no 


no 


no 


no 


no 


no 




X'lacros 


no 


no 


no 


no 


no 


yes 


yes 


t: 


Set multiple marl^ in text 'l^^^^^^^^^^^^^l 


^Bv "° 


yes 


no 


yes 


no 


no 


no 




Size of manual 


med 


nicd 


small 


large 


small 


large 


med 


1 




^Ib^ 


no 


yes 


yes 


no 


yes 


yes 




N'lanual on disk or printed 


disk 


disk 


pntd 


pntd 


pntd 


pntd 


pntd 


t 




■B' yes 


yes 


no 


yes 


no 


yes 


yes 




Print preview 


yes 


no 


no 


no 


\'es 


no 


yes 


f 


Printer > 80 columns ' '^l^^^^^^^^^^^^^l 


^K >"' 


yes 


no 


yes 


no 


yes 


yes 




Print disk dircctoiA' 


\'CS 


no 


no 


no 


no 


no 


no 


I 


Send special printer codes .^■j^^^^^^^ljjH 


HP' y^^ 


no 


yes 


no 


yes 


yes 


yes 




Print selectetl pages 


no 


no 


yes 


yes 


no 


yes 


)-Cs 


t:. 


Print from any page '^jHUJ^^^^^^H 


^ yes 


no 


yes 


yes 


no 


yes 


yes 




Double column printing 


yes 


no 


no 


no 


no 


)es 


)es 


1 


Variable paragraph spacin^^^^HI^^^^^^I 


HI' yes 


no 


no 


yes 


no 


yes 


no 




User configure printer driver 


\es 


no 


yes 


)X-S 


ltd 


ltd 


yes 


1 


Multiple printers drivers "^^HB^^^^^^^^^H 


HK "° 


yes 


2 


yes 


no 


no 


6 




Separate print program 


no 


yes 


no 


yes 


no 


yes 


yes 


1 


Printing pre-Format required^^^^^^^^^^^^H 


^K "° 


no 


no 


yes 


no 


yes 


no 




Draft print option 


no 


no 


no 


yes 


no 


\TS 


no 


1 


Proportional print support:'^|^^^^|^H|^^^^H 


■B- y^' 


yes 


no 


yes 


no 


no 


no 




Print formatted liL lo di-=k 


yes 


no 


no 


)-es 


no 


\es 


>es 


k> 


, Include, or chaiii.external files at print dm6'^[H^H 


■^- y^s 


no 


no 


yes 


no , 


yes 


yes 



The following rated 1-5 where 5 = highest value; 



ST 

Writer 



1ST 
Word 



Haba Final Regent 
Writer Word Word 



Let~s 
Write 



r 


■Ease ofTeamirfg- " ' ''' '"^H 


m 








f 3 


5 


5 


2 


3 


gH 


m^B 




Complexity o: documentadon 










3 


2 


1 





2 


5 




r 


Completeness of documentadon 


m 








HK: 


5 


4 


3 


3^ 


l^^l 


H[ii^i 




Clarity of manuals 










4 


4 


5 


2 


3 


4 




1 


Suitable for beginner ^«J^H 










f-1- 


4 


S 


1 


mi 


^m 


^^m 




Suitable for professional 










4 


2 


3 


5 


1 


3 




1 


Ease of use "'9^1 










1 3 


4 


5 


1 


3'" 


1 


"i^mn 




Price range (5 = high) 
















I 


■-, 


2 


4 




I 


Use of available memory . i^JH 










1 5 


3 


4 


2 


4 


5 


HH 




Use of disk/drives 
















4 


? 


2 


3 




f 


Quality of screen display -'i^| 










fe. 5 


5 


5 


5 


4 


5 


'fl^H 




Dis[ilay speed 










1 


3 


3 


5 


5 


4 




^■ 


Print Bexibility '1^ 










1 3 


4 


3 


5 


2 


5 


9RB 




(Editor's Note; Data items for Let's 
Other data by author Because Hems 


Write provided by 
in laat chart are si 


SolGuber Data Jar '1l- 
ihjective, TextPro n not 


aPra pre. 
meluikd 


S12I«I /.y 


Amie Lee 


■. Prcsideiil 


0/ Ahai I 


IS Software. 
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SWAPPING 
ART 



WITH 
COMPI 



kDARD, 



•:•:•:•:<:•:•> 



§ ■ /le Interchange File Format (IFF), originally 

•:•; developed for the Amiga computer, is now avail- 

"X ', 

% able on the ST. Graphics block transfers — true "clip 

X' 

:*;: art" — and Amiga picture compatibility are 

•X provided, courtesy of Tom Hudson. The author of 

XJ DEGAS Elite and CAD-3D explains how to use this 

j:|: new graphics standard. Folder IFF.STQ on your 

;•:; START disk contains all necessary source code for 

\\ the routines, two sample programs to read and 

\\l write your own IFF picture blocks, and some sam- 

v: pie picture segments. >. 






•:• 






]-SrA/iT,'lhe ST guarje'rly^ 
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SWAPPING... 

While developing DEGAS Elite, the full- 
featured version of DEGAS, I decided the 
program should have true "dip art" cap- 
ability, such as that found on the Macintosh. This abiUty to 
transfer portions of a graphics display (bit-blocks) from one 
program to another has been missing from the Atari ST. It's 
not that it hasn't been done, it's just that ST developers have 
not agreed upon a standard file format. 

Originally, I created a very simple bit-block format for 
DEGAS Elite pictures that would work fine for Atari users. But 
what if someone wanted :o import images from, say, the 
Commodore Ami^ computer? A simple Atari-only formal 
just wouldn't do, 

I consulted several prominent ST developers lor their opin- 
ions, and we decided that Atari bit-block images should be 
stored to disk in the Electronic Arcs Interchange File Format 
(IFF), 

The Interchange File Format is a set of file standards devel- 
oped by Electronic Arts so that computers of all types can 
easily exchange a variety of files: graphics, music, text, and so 
forth. Originally implemented on the Amiga, this format will 
be the perfect way for the6T to communicate with any other 
computer that supports IFF 

Why support IFF files? Take a look at the computer indus- 
try. Every computer manufacturer has a different notion of 
how things should be done You can't use an Amiga or Macin- 
tosh disk in an ST drive- they use different formats to store 
their data. You can't plug an IBM graphics card into an Apple 
11, The major drawing programs on the ST alone use different 
picture storage formats! The computer industry needs stan- 
dards, and the IFF file is a move in the right direction. With 
it, we take an important step toward computer compatibility. 

With a proper standard defined and adhered to by the 
many ST software developers, we will have a uniform method 
for exchanging graphics information between applications 
such as paint programs, page-layout programs, charting pro- 
grams, or word processors. One program can create a graphic 
image and write it to a disk file, then another program can use 
that image in whatever way is required. In addition, it will be 
much easier to port software from one computer to another 
because they will use the same file-handling routines! 

This article will describe a uniform method of storing 
graphic bit-blocks in IFF disk files, and provide commented 
C source hstings demonstrating the reading and writing of the 
files. In addition, the START disk contains example block im- 
age files along with the ready-to-use source code, so that 
START readers can begin supporting the file format im- 
mediately 



(Editor's note: START agrees with Tom Hudson and the developers 
supporting him on this. We urge all ST developers to adopt the IFF 
format as an ST gi'aphics standard. Nonprogrammers and others 
who just want to use the IFF programs on their START disk will 
jind instructions near the end of this article. We advise reading the 
article for infonnation that will make the instmctions clearer.) 

MEMORY rORMS 

Before examining IFF and adapting it to the ST, we must 
understand how the ST itself transfers bit blocks. Whenever 
the ST's graphics routines perform a bir-block transfer, they 
must be informed how the graphic informahon is laid out in 
the system memory. This is known as a memory form, and 
may be in several formats depending upon the image's resolu- 
hon and how the program created the image. 

Typically, the ST programmer uses the GEM VDl bit-block 
manipulation functions, vro_cpyfm() and vTt_cpyfm(), to 
move image blocks around. These functions are passed the 
format of the bit-mapped image with an array of values 
known as a Memory Form Definition Block (MFDB), Most appli- 
cations will require the use of the vro_cpyfm() function 
(opaque color form to color form operation) rather than the 
vrt_cpyfm() funchon (transparent, single-plane form to 
color form) because the latter is mainly used to turn a mono- 
chrome image (such as a block of text) into a color image. We 
will only work with the vro_cpyfm() funchon in this arhcle. 

An MFDB is a ten-word array of values in which each 
word entry is a part of the information defining the bit-block. 
Its format is as follows: 

MFDBiOl - High word of memory form starting address 

MFDBUl-Low word of memory form starting address 

MFDB121-Form width in pixels 

MFDB[31-Form height in pixels 

MFDBI4l-Form width in words 

MFDB[51-Form format flag 

MFDBi6l-Number of memory planes 

MFDB171 - Reserved (0) 

MFDB[81-Reserved(0) 

MFDBI9I- Reserved (0) 

The first two entries of the MFDB array are the longword 
address of the start of the bit-block broken into high and low 
words. These two word values tell the VD! where the bit- 
block memor}' form is located m memory. For memory forms 
that arc standard ST screens, this value will be the base ad- 
dress of the screen RAM. 

The third entry in the MFDB array is the form width in 
pixels. This is quickly calculated as: 
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Rightmost pixel number -Leftmost pixel number + 1 

For an entire ST screen, this value will be either 320 (low- 
resolution mode) or 640 (medium- and high-resolution 
modes). 

The fourth entry in the MFDB array, tlie form height in 
pixels, is equally easy to calculate: 

Bottommost pixel number -Topmost pixel number+1 

For an entire ST screen, the height in pixels will be either 200 
(low- and medium-resolution modes) or 400 (high-resolution 
mode). 

The fifth entry tells the VDl in which iormat the bit-block 
image is stored. There are two formats supported by the VDI: 
standard form (1) and device-specific form (0). For our pur- 
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poses, we will use only the device-specific form, smce this is 
the format used in ST screen image data. 

The sixth MFDB value, the form width in words, is the 
number of 16-bit words required to hold one line of pixels. In 

C, this value can be calculated as; 

(Width in pixels + 15)»4 

Finally the number of memory planes is either 4 Clow- 
resolution), 2 (medium-resolution) or 1 (high- resolution 
monochrome). 

The last three entries m the MFDB array are resetted lor 
future use in the VDI. Set them to zero, to avoid unexpected 
results in future versions of the VDI. 

Once you have properly defined the MFDBs for the source 
form (where the bit-block is being moved from) and destina- 
tion form (where the bit-block is being moved to), you can 
use vro_cpyfm() to move a bit-block from one memory 



form to another You can use the same MFDB for both the 
source and the destination if needed, but it's best to perform 
a bit-block transfer (bitbit) using two separate mcinoiy forms 
to avoid overlap conflicts. 

MOVING A BIT BLOCK 

Moving a block around is actually very simple, but you must 
know where the block is and where you want it to go. To do 
this, you must set up two MFDB arrays, one for the source 
form and one for the destination form. Normally, one of the 
memory forms will be a screen RAM area, and the other will 
he a user-defined holding buffer for the bit-block. 

Setting up a user-defined portion of RAM for the image 
buffer is quite easy Calculate the size of the picture in bytes. 

Number of planes* Width in words --i-2*Height in pixels 

This value is then used as a parameter for the memory alloca- 
tion function, MaIloc(), Note that it isn't necessary to allocate 
an entire 32000 bytes (the full size of an ST screen) for your 
bit image For a low-resolution (4 bit planes) bit-block 33 
pixels wide (3 words) and 12 pixels high, the RAM required 
is only (4*3*2*12), or 288 bytes. Calculate the RAM 
needed, allocate it, and plug the starting address of the allo- 
cated RAM into the first two entries of the MFDB, (We'll look 
at an example of this later.) 

Once you have both MFDBs defined with properly allo- 
cated sections of RAM, you need to set up another array 
which tells vro_cpyfm( ) which part of the source form you 
want to move, as well as where to place it in the destination 
memory form. This is an eight-entry array with the first four 
words defining the source rectangle, and the last four words 
defining the destination rectangle For example, to move the 
rectangle with upper-left coordinates 30,40 and lower-right 
coordinates 50,45 to a rectangle on the destination form with 
upper-left coordinates 0,0 and lower-right coordinates 20,5 
(be sure the two rectangles are the same size), the coordinate 
array (we'll call it COORD) will look like this: 

COORDI0l = 30 
COORDI11 = 40 
COORD12I = 50 
COORD[31 = 45 

COORD[41= 
COORDI51= 
COORD[6I = 20 
C00RDI7I= 5 
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Now all the preliminary daca is set up. We have properly 
described the memory forms and the portion of the source 
form we want to move We're ready to do the bitblt operation 
with the vro_cpyfm() call. It is structured as follows: 

vro_cpyfm(handle, wr_mode, COORD array, source 
MFDB, destination MFDB) 

The handle is the device handle of the graphics worksta- 
tion you are using, assigned when you open the virtual work- 
station with the v_opnvwk( ) function. 

The wr_inode is the writing mode to use in the bitblt 
operation, numbered from 0-15, and described in the GEM 
VDi manual, page 5-6. For our purposes, we will always use 
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mode 3 (replace mode), where the source block is copied 
into the destination form exactly as it appears in the source 
form. The other 15 writing modes can be used for special 
masking effects, and you can experiment with them to see 
what they do. 

The COORD array is the eight-word array described 
earlier which tells the VDI the coordinates of the bit-block to 
move 

The source MFDB is the pointer to the MFDB of the form 
we're moving the block from. 

The destination MFDB is the pointer to the MFDB of the 
form we're moving the block to. 

When vro_cpyfra() is called, the bit-block will be copied 
from the source form to the destination form, and if the two 
MFDBs are different formats (as in the source form being a 



standard ST screen and the destination form being just the 
size of the bit-block), the VDI will convert the form's format 

accordingly 

INTERCHANGE FILE FORMAT 

Now that you know the basics of setting up a memor)' form 
and copying a bit-block from one form to another, let's see 
how to store bit-blocks in a disk file for later use. This is 
where the IFF file format comes in. 

The IFF routines on your START disk are a subset of the 
full IFF specification. These routines can handle bit-mapped 
images of various resolutions quite well but do not handle 
text or any of the other IFF file types. They are easy for the ST 
programmer to use because they take standard GEM VDI 
Memory Form Definition Blocks and ST palettes as input; the 
programmer doesn't have to deal directly with the IFF files. 
When reading the IFF file, the routines take care of most con- 
ditions that can occur, and return palette information in both 
a system palette table and a GEM color format. In short, the 
routines make reading and wrinng IFF files a quick and pain- 
less task for the ST programmer 

The IFF bit-block files we'll be using have a standard for- 
mat, shown below. For ST IFF bit-block files, 1 suggest three 
standard extenders: For low-resolurion (16-color) images, use 
BLl; for medium-resolurion (4-color) images, use -BL2; and 
for high-resolution (monochrome) images, use .BL3. These 
correspond to the .P11/.PI2/.PI3 extenders used by the 
DEGAS paint program, which allow users to quickly identify 
the resolution of the image contained in the file. This will be- 
come important when images begin to appear on bulletin 
board systems with httle documentation. 

Each IFF bit-block file begins with the four-character 
identifier FORM followed by a four-byte longword indicating 
the length of the file (not counting the FORM header and 
length code). The program reading the IFF file should check 
for this header to be sure the file is in the proper IFF format. 

Following the FORM header is the four-character code 
ILBM, which stands for InterLeaved Bit Map (not to be con- 
fused with ST Bit-Plane Interleaving). This code lets the read- 
ing program know the file contains an IFF bit-block image. 

Next comes another four- character identifier. BMHD, 
which stands for Bit Map HeaDer It is followed by a four-byte 
longword indicating the length of the header The length is 
expected to be 20 bytes with the following structure: 

Byte 

Offset 

word -Width of form in pixels 
2 word - Height of form in pixels 
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4 word-X pixel location {assumed to be 0) 

6 word-Y pixel position (assumed to be 0) 

8 byte ~ Number of bit planes 

9 byte-Masking flag-unused in our routines 

10 byte -Compression flag-0 = No compression, 
1 = RLE 

11 byte-Unused filler byte 

12 word -Transparent color pixel value {normally 0) 

14 byte-X Aspect ratio (unused by our routines) 

15 byte-Y Aspect ratio {unused by our routines) 

16 word - Page width 
18 word - Page height 

Following the BMHD data chunk is the color palette infor- 
mation. This is another four-character identifier, CMAP 
(Color MAP), and it is also followed by a four-byte longword 
indicating the number of bytes in this data chunk. The data 
in this chunk is a group of three-byte structures, as shown 
below. Each three-byte RGB value represents one color: 

byte - Red value for color 
byte-Green value for color 
byte -Blue value for color 

The color information in each ol these bytes must be 
aligned with the most significant bit. For example, the ST's 
palette registers contain red, green and blue settings ranging 
from 0-7, which requires three bits to store. In a byte, these 
bits are stored like so: 

OOOOOXXX 

To make the value conform to the IFF format, we shilt the 
color- register value to the left five bits, so that the most 
significant bit of the byte contains the most significant bit of 
the color data, like so: 

xxxooooo 

For a low-resolution image, the color map contains 16 
chree-byte entries; for a medium-resolution image, it contains 
four three-byte entries; for a high-resolution image, it contains 
two three-byte entries. 

One problem arises at this point. When transporting bit- 
block files from the Ami^ (which allows up to 32 colors) to 
the ST (which allows only 16 colors), the ST routine must 
drop some of the colors and their corresponding bit planes. 
When this happens, the first 16 colors are used, and the rest 
are discarded. The same applies for the extra bit-planes. The 
IFF routines supplied here can read one resolution bit-block 
and turn it into another resolution, but be warned that read- 



ing a bit-block image file into a memory form with fewer bit 
planes (such as reading a .BLl file into monochrome mode) 
will probably render the image useless. You can read blocks 
with fewer bit planes into a form with more bit planes with 
no trouble-the colors will show up properly 

After the color map, the last data chunk in the IFF file is 
the bit-mapped image itself This is preceded by a four- 
character identifier BODY and a four-byte longword specify- 
ing the length of the bit-block data. 

The BODY can be written in two difierent forms: uncom- 
pressed and compressed. The compressed format uses a sim- 
ple Run-Length Encoding RLE scheme (see Reference 2). Note 
that the IFF Reader on your START disk will read both un- 
compressed and RLE-format bit-block data, but, for simplic- 
ity's sake, the write routines will only write uncompressed 
data. If you like, you can modify the write routine so that it 
supports the RLE option. 

This is a simple overview of the IFF bit-block format. As I 
said eariier, the IFF routines do most of the work for the pro- 
grammer and a detailed knowledge of IFF format is not 
needed to use them. However, if you would like to get full in- 
formation on compression format and other details, you 
should read the Electronic Arts "EA IFF 85 Standard for Inter- 
change Format Files" document (see Rtjerence I), 

IFF FILE HANDLING ROUTINES 

The file IFFRTNS,C on your START disk is the C source code 
for the actual IFF I/O routines. To use this in your programs, 
compile it into a ,0 (object) file and place it on your linker 
disk. Whenever you want to use the IFF routines, hnk the 
IFFRTNS.O file with your program, and you're ready to go. 

There are three routines in the IFFRTNS.C file that you will 
be concerned with: iff_rdl(), iff_rd2() and iff_wrt(). All 
these roudnes and their support functions are documented 
for your use. 

The IFF I/O routines make several items available The 
Syspall) array is a 16-word array which holds the color- 
palette informadon as used by the Setpallete() call That is, 
each entry ranges from $0000-0777, where $0000 is black 
and $0777 is white. 

The Gempal[16l[31 array is an array of color values used 
by the GEM vs_color() function. This array has 16 groups of 
three values, where GempallHOI is a value from 0-1000 for 
the red portion of the color, Gempallllll is the green compo- 
nent, and Gempalil[2l is the blue component. 

Finally, the xparent variable is an INT value that tells 
which color is assumed to be transparent. This will typically 
be the background color index, 0. 

The colors in a block file may differ from the color palette ► 
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that your program is using. Because of this, [he block images 
may not look correct when loaded. With the color-palette in- 
formation supplied with each block, you can do what is 
termed a "color re-map" - that is, you can process the pixels 
in the block image and replace the old pixels with the color 
from the current palette which most closely matches the 
original pixel color. This rather complex operation requires 
specialized assembly language and is beyond the scope of this 
article 

IFF I/O FUNCTIONS 

The iff_id() function, used internally in the IFF 1/0 routines, 
reads a four- character data ID and the four-byte length into 
the chk structure. 

The proc_CMAP( ) function is used after the color map 
(CMAP) chunk has been located. It reads the color values 
Irom the block file and transforms them into both the ST 
BIOS format (in the Syspalll array) and the GEM format (in 
the Gempalllll array). 

The decompressO function takes care of reading bit-block 
images which were written using the RLE compression 
scheme. Decompression is done one scan line at a time. 

The rawreadO function does the same thing as decom- 
pressO, but with block image data chat is not compressed. 

The rawwriteO function writes a scan hne of uncom- 
pressed data to a disk file. As mentioned, there is no corre- 
sponding compressC ) function here, but you can add one to 
write image data in a compressed form, if you like The Read 
routines can handle either format. Compression on writing 
was not supported primarily because small block files benefit 
little from RLE compression. 

The lorasterO funcnon does the job of converting the raw, 
uncompressed scan line data into the ST's device-specific "in- 
terleaved" bit-map format. This screen data format is dis- 
cussed in the article "GRAFCON ST" in the July, 1986 issue 
of Antic magazine. 

The fmrasterO function does the opposite of the 
lorasterC) function. That is, it takes a scan line of device- 
specific data and converts it into the form required by the IFF 
data file. After this routine, the data is ready for writing (or 
compression, if you choose to install RLE compression). 

The iff_rdl() and iff_rd2C) functions are the actual func- 
tions called to read an IFF file. This is a two-phase operation: 
You furnish an MFDB array and the handle of a file opened 
for input, and call iff_rdlC). This funcnon reads the starting 
pordon of an IFF file, sets up the MFDB array to let you know 
how the block is laid out, and returns. Using the information 
in the returned MFDB, you allocate the amount of RAM the 
block needs and call ifF_rd2() to complete the read process. 
This operation is shown in detail below. 



The ifr_wrt() function is used to write a bit-block to disk. 
You furnish the handle of a file opened for output, the MFDB 
of the block, a color palette in the ST BIOS format, and the 
resolution of the image. This process is also shown in detail 
below 

READING IFF FILES 

As mentioned, the IFF file-read process is a two-stage proc- 
ess, !FFREAD,PRG, on your START disk, is a program demon- 
strating the reading of IFF block files. Sample block files of 
the three different resolutions are supphed on the START 
disk. Files with .BLl extensions are for low-resolurion, .BL2 
files are ior medium-resolution, and .BL3 files are for mono- 
chrome Try reading various resolution block files in the ST's 
three graphics modes to see how each looks. The following is 
an explanation of the source code found in IFFREAD.C 

IFFREAD starts by opening a virtual workstation and re- 
questing the screen's location in memory and its resolution. 
The color palette is also placed in the oldpall] array for later 
restoration. Important: always restore the color palette after 
your program is done so that when the system returns to the 
Desktop, it is the same as it was before your program ex- 
ecuted. This is not only considerate to the user, but it msures 
that the Desktop screen will be readable! 

Next, the program builds the screen's MFDB array This is a 
fairly straightforward operation. As you can see, it plugs the 
appropriate values into all ten scmmfdbl] array locations. Be 
sure to always place zeroes into the last three MFDB locations 
to insure compatibihty with future GEM VDI releases. 

Now we bring up the GEM file-selector dialog and let the 
user select the IFF block file to load. Once the filename is en- 
tered, the program displays the whichfm dialog to ask the 
user where to load the block image. 

The whichfm dialog lets you choose how the block file 
will be loaded. If SCREEN is chosen, the block will be loaded 
into the screen's MFDB, regardless of the block's size In this 
case, the block is read into the upper-left corner of the screen, 
showing that a block can be read into any size memor)' form. 
Of course, the only usable portion of the form is the block 
itself 

If FORM is chosen in the dialog, the program will allocate 
the amount of RAM required for the bit-block in a part of 
RAM separate from the screen, read the block into that RAM, 
then do a bitblt to copy the block to the center of the screen. 
This is a tnple-edged demonstration, showing how to allocate 
RAM, bring in a bit-block to a special buffer, and how abubU 
operation works. 

After SCREEN or FORM is chosen, the program attempts 
to open the file requested by the user If it is opened success- t 
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fully, the program attempts a firsc-stage IFF read using the 
iff_rdl(} function. The program passes the file's handle 
(fhand) to the function along with a 10-entry MFDB array 
(workmfdb) which the function will set up according to the 
block's size. 

The iff_rdl( ) function returns a value of zero if the first- 
stage IFF read was successful. If the value is negative, an error 
has occurred. The error numbers and meaning are found in 
Che #dennes of the IFFRTNS.C file. 

After iff_rdl( ) executes successfully, Syspalll and Gem- 
pallH] will be filled with the color values found in the IFF file 
The MFDB array you specified in the iff_rdl( ) function call 
will be filled with the data for the bit-block except for the first 
two array entries. These entries, you should recall, contain the 
address of the memory form block, which the IFF Reader 
routines cannot determine. This is up to you, and we'll see 
how to do it in a moment. 
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The first thing IFFREAD does is check to see if either the 
width or height of the image is too large for the ST screen. If 
so, the MFDB values for these settings are adjusted to the 
maximum size of the ST screen. Excess size conditions can 
occur if you try to read a large monochrome image into a low- 
resolution screen (since monochrome images are 640X400 
pixels and low-resolurion images are 320X200 pixels). This 
operation will truncate the block to a usable size. 

Next, we set the number of bitplanes in the form to the 
same number as the resolution that is in use. If the form has 
excess bitplanes, they are ignored. In the demonstrahon pro- 
gram, this is accomplished by: 



workmfdb[6l = 



nfdbiei; 



If the user requested that the block be loaded into the 
screen (formtype==l), the address of the memory form is 



set to that of the current screen, which is in the scrnmfdblj 
form entries 101 and 111. To read the block into the screen, we 
must also make sure the block's width parameter 
(workmfdbl4I) matches that of the screen. 

If the block is to be read into a memory form separate 
from the screen (formlype= = 2), we have to do alicde more 
work. Specifically, we need to ask the operating system to al- 
locate enough RAM for the bit-block's form. Fortunately, we 
can allocate just the right amount of RAM required for the bit- 
block-which can be as few as two bytes or as many as 
32000 bytes. This prevents wasted memory. 

To determine the amount of RAM needed to hold a bit- 
block, we do the calculation: 

blocksize - MFDBI3I * MFDBI4I *MFDBI6i * 2; 

This value is then used as input to the GEMDOS MallocC) 
(memory allocahon) call, which sets aside the 1M.M we need 
and returns the address of the allocated RAM. If the allocation 
is successful, we plug the RAM's address into locarions 101 
and 111 of the workmfdbll array. The rest of the MFDB is left 
as is. 

Now that the MFDB is set up with the address of the 
memory form and the number of bit planes we intend to use, 
we call iff_rd2(). This function actually reads the bit-block 
into the area we defined via workmfdbll. If the read is suc- 
cessful, a zero is returned, otherwise, a negative value is 
returned (see the error code #defines m the IFFRTNSC file). 

After the phase 2 IFF file read has executed, the file we 
opened should be closed, since we're done with it. 

If it is necessary to set the colors to those of the block, you 
can do it in two ways, as shown in the example program. The 
SetpalleteO call is the easiest, but you can also use the vs_ 
color() function to do the job. The result is the same in either 
case -it's a matter of personal preference In the IFFREAD 
demo, we go ahead and set the colors in both ways so that 
you can see the block as it was stored. 

If the block was read into the screen RAM, no further ac- 
tion is necessary, since the block is in view already 

If the block was read into a memory form other than the 
screen (formtyp= =2), we'll have to copy it to the screen to 
view it. To do this, we set up the blitll array with the coor- 
dinates of the block in its source form in blitlOl through 
blitlSI. We also set up the coordinates of where we want the 
block to be copied in the destinahon form (the screen) in 
blit[4I through blitl7l. For proper results, make sure the 
source block size and the destination block sizes are the 
same. IFFREAD copies the block to the screen so that it is 
centered horizontally and vertically The actual instruction to ^ 
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do the bitblt operation is vro_cpyfm(), described eadier. It 
uses the workmfdbll array for the source form, scrnmfdbll for 
the destination form and the blitfl array for the coordinates to 
copy. Try changing the coordinate values to see how the bitblt 
operation works. 

After you have viewed the loaded bit-block image, press 
any key to return to the Desktop. 

WRITING BLOCK FILES 

The IFFWRITE.C file on the START disk is the C source file 
for the IFFWRITE.PRG example program. With it, you can 
load any DEGAS-format picture and save portions of the pic- 
ture to disk in a standard IFF-format block file. These files 
will be compatible with DEGAS Elite's block-handUng capa- 
bility and any other program that supports the IFF-format 
block files. 

This program is quite straightforward. It is similar to 
IFFREAD in many places, so we'll cover mainly the important 
differences. 

The program begins like IFFREAD by opening a virtual 
workstation, setting up the screen's MFDB, and so on. It does, 
however, perform an extra setup function. In order to prepare 
to write one of our block files, we must have a secdon of 
memory reserved to hold up to a screenful of data-or 32000 
bytes. This is done with the Malloc( ) function. We ask the 
system for 32000 bytes of RAM, and it returns the starting ad- 
dress of the RAM, If this fails, the program informs the user 
with a dialog. Otherwise, we set the pointer workarea to the 
address of the RAM buffer 

Like IFFREAD, lEFWRlTE displays the file-selector dialog. 
This time, however, it wants a DEGAS-format picture hie as 
input, and automadcally searches for a file with a .PU, ,PI2, or 
.PI3 extender, depending on the current system resoludon. 
After the user enters the filename, the picture file is read into 
the current screen memory for the user to see The 16-entry 
INT array picpalH contains the color information for the 
picture. 

After the picture appears, the user points the mouse to the 
upper-left comer of the area to be saved, presses and holds 
the button, dragging it to the lower-right comer of the block. 
A "rubber box" appears to define the rectangle that will be 
saved. 

When the button is released, the program calculates the 
size of the bit-block and uses vro_cpyfm( ) to copy the block 
to the 32000-byte work area that was allocated at the start of 
the program. Before the bitblt operadon can be executed, 
however, the program must set up the MFDB for the rectangle 
This MFDB will be used to tell the IFF write routine where 
the block is and what its format is. 



Now the program displays a second file selector dialog, 
this nme expechng a block file name. When entering the file- 
name, be sure to add the ,BL1/,BL2/,BL3 extender so that you 
can identify the resolution of the block file later. 

After the block filename is entered, the program creates 
the file and instructs the IFF write routine, ifF_wrtC), to write 
the file. This is a simple one-stage process. The programmer 
furnishes the handle of the file that is opened as output, 
along with the MFDB for the block, the color palette that is to 
be used for the block, and the block's resolution (0, I, or 2), 
The IFF write routine does all the rest and returns a to indi- 
cate success or a —1 to indicate failure. After the write call 
returns, the program closes the file and the write process is 
complete! What could be easier? 

An interesting side-benefit of this program is that if you 
"grab" the endre screen with the rubber box and write it, the 
resulting block file is directly usable by all Ami^ paint pro- 
grams that support IFF, making the program a handy DEGAS- 
to-IFF converter! Aren't standards wonderful? 

FINAL NOTES 

Remember: though these routines are flexible and will allow 
you to use any bit-block image regardless of resolution, load- 
ing an image with more bit planes than are used in your par- 
dcular graphics mode may make the image unusable If in 
doubt, just force the user to use .BLI, .BL2 or .BL3 files, de- 
pending upon the resoludon. This way, the images wifi always 
be usable. 

Using the IFF file-read routines shown in this example, 
you can load many different bit-block images into separate 
areas of computer memory for use by your own programs. 
Whether you are an ST developer or an involved program- 
ming hobbyist, these rounnes should prove valuable for using 
bit-block files in your own programs, ■ 

REFERENCE: 

EA IFF 85 Standard for Interchange Format Files from Jerry Mor- 
rison, Electronic Arts, Available through Commodore-Ami^, 
1200 Wilson Drive, West Chester, PA 19380 

GRAFCON ST, Universal Graphics Converter by Patrick Bass, 
Antic Magazine July 1985, pp. 67-72, 

GEM VD! Manual, Digital Research, Inc., pp. 6-1 through 6-8. 

Atari ST GEM Programmer's Reference by Norbert 
Szczepanowski and Bemd Gunrher, Abacus Software, pp. 

157-161. 
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CDIEPUTER CREflim 



ACTIVIEION 

Boriowed Tin 

Palntworka. . 
ANTIC 

Maps and Lee 

Disk Doctor, 
A-CjIc 

CAD-3D 

GST c ccraoU 
Expect Oplnl 

Hed Alfrt. . . 
AT AH I 

Home Planets 
IATTERIE3 INCL 

Degas 

Tlmellnk 

IIPPOPOTAHUS 
HIppoword. .. 
Hlppoconcept 
Hlppnslmple. 

Hippo Ramdls 
Hippo Comput 

Hippo Alt 1. 
Hippo Pixel. 

Hippo Lasei. 
Hippo Eptom 

Hippo vision 

DOS Shell.. 
Peiaonal Moi 

Eoftapool. . 
Flip Side. , 
calendar. . . 

Mi-Tetm 

Gold Runner 
Time Bandit! 
BBS 

Mlqlity Mall 
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PRINTERS 
STAR HICHONICS 




PANASONIC 









































in 520 ST Cor 
Package 02 



10 ST HARDWARE: CALL 
Package )f1 

ipulerSSF354 Disk Drive 



CALL FOR PACKAGE PRICES 

SF 354 SS/DD Disk Drive Call 

SF 314 DS/DD Disk Drive $209 

SM 124 Monodirome Monitor Cail 

SC 1224 Color Monitor $329 

SHD 204 20 UG Herd Disk Call 



3'/2" 


Sony 


Sony 


Bulk 


SS/DD 


DS/DD 


10-29 


LSSoa. 


2.49 ea. 


30 + 


LSSaa. 


2.39 e&. 




3'/!" 


Sony 


Sony 


Box (5) 


SS/DD 


DS/DD 


2-6 


11 Bx. 


ISBx. 


7+ 


10 Bx. 


15 Bx. 



To order call TOLL FREE 

1 -800-824-7506 



ORDER LINE ONLY 



^^==r^ COMPUTER CREATIONS, I 



^^n/M-- 



.r 



nc. 

P.O. BOX 493 - DAYTON, OHIO 45459 

For information, order inquires, or for Ohio orders (513) 435-6868 

.D. (add S3. 00). F 



is Open 9:00. 

. flipping on all Hardware orders (mm $4.00). Software and accessories add 13.00 shipping 
feCanada, Alaska, Hawaii, Puerto RicoandAPO. Ohio residents add 6'/!% sales tax, Canadie 
aping, (mln. $10) For Imrnediate delivery send casliier'scheck, money order or direct bank t 
Jers welcome. Due to our low prices, all sales are final. NO CREDITS, All deteclive returns r 



not b 



I accepted tor replac 



inlyl Please 

Id handling in continental U.S. Actual freight will be charged outside 
orders add Sii shipping, {min. S5.00|. All older (oraign orders, please 
nsfers. Personal and companychecksaiiowSweeksto clear. School 
isl have a return authorization number. Please call (51 3) 435-6B68 to 
" " -- - - )t bill until we 



ISK INSTRUCTIONS 



^M ^I^V eicome. 

Hvl^F All programs and program listing in this 
^V ^V issue are on your START disk provided in a 
special envelope bound into the magazine, (If you purchased 
[he $4 version of STAKT, without disk, you can still purchase 
the disk by sending us the bound-in card or mailing $10.95 
plus $2.00 for postage and handling, to START DISK, 524 Sec- 
ond Street, San Francisco, CA 94107.) 

Use a pair of scissors to open your disk envelope along the 
outside vertical edge. Place your START disk into drive A and 
double-click on the disk icon to see its contents. Please refer 
to your ST owners manual if you are uncertain about proper 
Desktop procedures. 

Your START disk contains nine folders. Each folder cor- 
responds to a particular START article. To open a folder and 
reveal its contents, double-click on the folder's icon. Before 
running a prograrti, we recommend that you read its related 
article and transfer its hies to another disk. Also, it's a good 
idea to back up your START disk before use, 

COMPRESSED FILES 

Some of the hies on the START disk are in a compressed for- 
mat. You can identify them by a "Q" as the second letter of 
the filename extender (e.g., XLISRTQP). These files are un- 
usable unless first decompressed with the Un-Squeeg pro- 
gram included on your START disk. We chose the Squeeg 
program horn Quack Computer Company as the most 
efficient compressor of ST files. Only the Un-Squeeg program 
(the decompressor) has been included on your disk. Please 
note that this program is owned and copyrighted by the 
Quack Computer Company and is not to be considered pan 
of the public domain. The latest Squeeg/Un-Squeeg package, 
which includes the compression program, is available for 
$24.95 from: 

Quack Computer Company 

257 Robinson Avenue 

Bronx, New York 10465 

(516)689-8738 

DECOMPRESSING 

To decompress a file, first transfer both the compressed file 
and UNSQUEEG.PRG to another disk. When run, the Un- 
Squeeg program will create a second, decompressed file 



which may be more than twice the size of the compressed 
one Un-Squeeg will not alert you if you run out of disk space, 
so make sure you have plenty of room on your destination 
disk. 

Alter transfering the files, double-click on UN- 
SQUEEG.PRG and a file selector box will pop up requesting 
the file to decompress. Un-Squeeg automatically searches for 
filenames with "Q" as the second letter of the extender Select 
a file to decompress and click in the OK box. Un-Squeeg 
responds by asking for a destinahon path. At this point, it is 
easiest just to select the defauk (drive A) by clicking in the 
OK box. The file will be decompressed and written to disk 
with the original, unsqueezed filename (e.g., XLISPTQP will 
be decompressed and written to disk as XLISETTP). 

As an example, we'll step you through the decompression 
of the XLISP program: 

1. Drag UNSQUEEG.PRG to a blank, formatted disk in 
drive A, then open the XADVISOR.STQ folder by double- 
clicking on it, and drag XLISPTQP to drive A. (If you plan to 
go on and use the programs from the Chabris Al article, this 
might be a good time to drag all the files within the XADVI- 
SOR.STQ folder to drive A. There will be plenty of room.) 

2. Double-click on UNSQUEEG.PRG from drive A to mn 
the Un-Squeeg program, 

3. The Un-Squeeg program will begin with a file-selector 
box requesting a file to decompress. Click and highlight the 
file XLISRTQP, then click m the OK box. 

4. Un-Squeeg will respond by asking for a filename to 
write the decompressed file to. The filename will default to 
XLISETTP on drive A. For this example, select the default by 
clicking in the OK box. 

5. The file XLISPTQP will be decompressed and written 
out as XLISRTTP When the Un-Squeeg program is done, it 
will query you for another file to decompress. Click in the 
CANCEL box to exit to the Desktop. The decompressed 
XUSP flic, XLISRTTP will now be on drive A and ready to 
run. 

ADDITIONAL INFORMATION 

Detailed information on batch (lies, program compilation, 
and program assembly is contained in the READMETXT ii\e 
on your START disk. All Programs were compiled and tested 

on a 520 ST with TOS in ROM, using the Atari Developers Kit 
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PUTEZ CALC^'^TO WORK 
FOR YOU AND BENEFIT 
FROM THE RESULTS 



EZ CALC™is a fully implemented GEM™ \a, 
based spreadsheet tor home and business 
use. This is by far the most powerful 



1 

spreadsheet available for the price. Better [ZI 
yet, all commands are mouse controlled 
tor speed and ease of use, EZ CALC'^'^ 
also uses less memory than other spread- 
sheets for the ST, leaving more room for 
your data and formulas, II you've never 
used a spreadsheet before, you'll be 
amazed how easy EZ CALC^" is to learn 
and USB, The experienced user will love 
the speed of a mouse controlled spread- 
sheet. 



X^ 



EI-ECl ;"/ 
*~^ PHOHb 



BtciUuUtion DttiuHs Htip 



m m I mi.ii 
mtiim Vli.'i'i 
clbiiiVk * f Vui.ii 
"Fbflp ;" "Vrtui 




ONLY $69.95 

FEATURES 

1^ 300 columns by 999 rows 

.^ Extensive use of GEM^'^ windows 

t- All commands are under mouse 

control 
i^ Built in 10 keypad calculator 
^ On-line help windows [No commands 

to memorize) 
^ Built in sort routine 
1^ Developed exclusively for ttie Atari ST 
(-- 10 macros controlled by ttie function 

keys 
^ Split-screen capabilities 
^ Note Pad 




Extensive use of Ihie GEM '^ windows 

makeEZ CALC^^a fast, extremely easy- 

to- use spreadsfieet, Witti over 50 

commands available from ttie mouse, 

thie ease of use is unsurpassed. Imagine 

being able to move or copy an entire 

column of figures with a simple mouse 

control. 

■^ FULL FEATURED DEMO OF EZCALC AVAILABLE FOR S5, REFUNDABLE WITH PURCHASE, 



EZ CALC includes an easy to use 10 
key calculator that can be pulled down 
at anytime and operated either by 
mouse or keyboard. With the point of a 
mouse, the results of I hie calculation can 
then be transferred to ttie ceil of your 
ctioice. 



EZ CALC ""lets you attach a personal 
note of up to 4 lines to any ceil. The cell 
is then highlighted to remind you there 
is a note attached. For example, you 
could attach a note to the insurance cell 
of your personal finance spreadsheet 
reminding you that the cell applied only 
to car and home insurance, Ttie note pad 
yf can be pulled down at any time. 



Help Calc 

' Cnr ThA Atat 



For The Atari SV 



Onl 24 95 YlFYOUDONTHAVEOUR CATALOG ^ 



• 11 preprogrammed templates for use 
withEZ CALC™orVIP Professional™ 

• load-and-go and these templates will 
take the work out of tedious 
spreadsheet setup, 

Templates include: 



Check Register 




ional Finance Statement 

VIP PROFESSIONAL IS 
VIP TECHNOLOGIES. 



ST STAND 




ONLY $39.95 

-f $5.00 Min. Shipping & Handling 

Custom made just tor ttie ST, beautifully 
finished stand to tiold your ST monitor, 2 disk 
drives, a modem, disk files, ETC. 



YOU'RE MISSING OUT ! ! 




DELUXE DUST COVERS 

Deluxe Leather Grain 



PROTECT YOUR INVESTMENT ^3"^ 

Custom lilted, attractive lealtier Drown color 



• CDMPUTERS^lOO/aOO. 600(800' 1?00XL 65;i30XE 

■ DISK DRIVES— ASTRA 162D ATARI 1050 ST DRIVES 
ST HARD DRIVE INDUS GT. PERCOM SeSWBBSPD RANA 100 
TtiAK • PRINTEHS— ATARI 1025/10Z7 AXIOM SLP/GLP. 
OKtMATE 10 « HECORDER— ATARI JIO * MODtM -ATARI lO: 

• CO WPUTER— ATARI 520;i0i05T > PUjNTERS— AIARI a?5 
AXIOM 550 CITOHJPROWRIIER 8510 CPAflO/EP150 
EPSON MX/RX/LK/FXSO W/ & W/0 TRACTOR FEED 
dEMINKSTAR SG 10/X PANASONIC ID91'109? RITEMAN ll.'PH 



HELPMATE' 

The Atari ST' 



Only $29.95 



HELPMATE ST'^ 

• 10 Key calculator 



•Telep 

All in 


one 


natne mden 

program 


a 


J 




1 


HT 



The best par 

memoiy until 



itays "hidden" in 
;an be called up ior 
is running. The pull 
St ST programs 01 t:y 



Coming Soon!! 

INVENTORY .„,,.....sr- 

MASTER™ Only $99.95 

INVENTORY MASTER ™ is a power- 
ful, Inventory control and Report genera- 
tion program. It will do more ttian just 
keep track business inventory, sucti as: 
detailed report generation, fast and easy 
data retrieval, versatile data entry, takes 
ttre work out of decision making, plus 
much more. 



COMPUTER 
PAIACE ^^/W . 

■ ^^^'^■■^~^^" r/i^ rf J^ftly^/ riiere's never a penally lor using your credit canll 



USE YOUfl CREDIT CARD & CALL 

Toll Free 1-800-452-8013 

* ORDERS ONLY, PLEASE • 



OPEN M-F, 9-6 Sat ti 

2160W 1 nriA> 



=nue Eugene. Oregof 



For Information, Call (503) 583-5361 
Prices subject to cfiange without notice, 

CIRCLE 013 ON READER SERVICE CARD 



SHIPPING INFO 
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SJ 75 All Aclua) 
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all (503 


683-536 




WARRANTY INF( 
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THE DISK 

UNSQUEtG.FRG 
Double-click on this to 
decompress a file 
README.TXT 
Text file of inlonnatlon not 
included on the Disk Instruc- 
tions page. 

Parsers, Rooms, Objects 
and Trolls, page 54 

ADVENTURE.STQ 

ADVENTURTOS 

Double-click on this to run 

Adventure 

ADVENTUR.CQ 

Compressed Adventure C 

source code. 

ADVENTUR.BAT 

Adventure batch file 

EASYC.H 

Easy C de6nes, 

GAME.H 

Adventure C equates. 

PDEFINE.H 

Miscellaneous C defines. 

Which C for Me?, page 62 

BENCHMRK.STQ 

BENCHMRK.C 

Alcyon, Megamax, and Lattice 

source code 

BENCHMRK.GST 

GST C source code. 

BENCHMRK.BAT 

Dhampstone batch file (for 

Alcyon C). 

FujiBoink! page 109 

FUjIBOIN.STQ 

(See sidebar, pg. 113). 

FUJIBOIN.PRG 

Actual EujiBoink! runtime 

program. Be sure you have 

created all the data before 

running this program. 



FUJIBOIN.CQ 
Compressed EujiBoink! C 
source code. 
FUJIDRAW.PRG 
Draws the 32 images orthe 
fuji; creates FUJ1DRAW-D8A; 
run in low-res. 
FUJIDRAW.CQ 
Compressed EujiDraw C 
source code. 
FUJISHAD.PRG 
Calculates the reflective prop- 
erties of the fuji; creates 
EUJISHAD.D8A 
FUJISHAD.CQ 
Compressed FujiShade C 
source code. 
GETTITLE.PRG 
Loads a neochromc picture, 
cuts out the title screen, and 
creates TITLE. D8A. 
GETTITLE.CQ 
Compressed GctTide C 
source code. 
PEND.PRG 

Combines the three data files 
mto EUJ1BOIN.D8A. 
PEND.CQ 

Compressed Append C 
source code, 
FUJISTUFSQ 

Compressed interrupt routine 
assembler source code. 
FUJI-BAT 

EujiBoink! batch file 
TITLE.NEO 
Neochrome picture. 

Swapping Art with Other 
Computers, page 39 

IFFSTQ 

IFFREAD.PRG 

Reads in and displays an IFF 

data block (.BL_), (see pg. 44) 

lEEREAD.CQ 

Compressed IFF Read C 

source code. 



IFFREAD.BAT 
IFF Read batch file. 
IFFWRITE.PRG 
Reads in a Degas picture file 
and allows you to create an 
IFF block, (see pg. 48). 
IFFWRITECQ 
Compressed IFF Write C 
source code. 
1FFWRITE.BAT 
IFF Write batch file. 
IFFRTN5.0 

IFF Routines object code to 
Imk m with your own appli- 
cations. 
IFFRTNS.CQ 

Compressed IFF Routines C 
source code, 
1EFRTNS.BAT 
IFF Routines batch file 
BEE.BLl 

Sample low- resolution IFF 
block. 

CHARTBL2 

Sample medium-resolution 
IFF block. 
JETBL3 

Sample high-resolution IFF 
block. 

The Amazing MouseTrap 

page 19 

MOUSE.STQ 

MOUSTRAPPRG 
MouseTrap program; copy 
into an AUTO folder on your 
boot disk. If no AUTO folder 
exists, create one with the 
New Folder option from the 
Desktop menu. 
MOUSETRAP.SQ 
Compressed MouseTrap as- 
sembler source code. 
MOUSTRAPBAT 
MouseTrap batch file. 



MOUSEGAG.PRG 
Mouse practical joke; copy 
into an unsuspecting victim's 
AUTO folder, 
MOUSEGAG.SQ 
Compressed Mouse Gag as- 
sembler source code. 

Reversi Desk Accessory, 

page 12 

REVERSI STQ 

REVERSl.ACC 

Reversi Desk Accessory; copy 

into the root directory of your 

boot disk and turn on the 

computer with the disk in the 

main drive. 

REVERSICQ 

Compressed Reversi C source 

code 

REVERSI.BAT 

Reversi batch file 

Structured lO, page 77 

STRUCT! O.STQ 

STRUCTIO.TOS 

Double-click on this to see 

the Structured I/O Demo, 

Warning: creates a file EM- 

PLOYEE.DAT and expects a 

non write-pro tec ted disk in 

drive A (see pg, 78). 

STRUCTIOCQ 

Compressed Structured I/O C 

source code. 

STRUCTIO.BAT 

Structured I/O batch file 

STRUCTIO.INP 

Link68 input Ime for batch 

file 
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Probing the FDC, page 96 

TRAKREAD.STQ 

TRAKREAD.TOS 
Track Reader program (see pg. 
107). 

TRAKREAD.SQ 
Compressed Track Reader as- 
sembler source code, 
TRAKREAD.BAT 
Track Reader batch file. 

The Al Apprentice 
withXLISP, page 22 

XADVISOR.STQ 
(See sidebar, pg, 26). 

XLISRTQP 

Compressed XLISP program. 

In order to use any of the 



LISP programs, this file must 

be decompressed using the 

Un-Squeeg program. 

CHESS. RUL 

Xadvisor knowledge base for 

chess tactics. 

HIRING.RUL 

Xadvisor knowledge base for 

faculty hiring. 

INIXLSP 

XLISP initialization file. 

PPRINTLSP 

Pretty Print LISP utility 

XADVISOR. LSP 

Xadvisor LISP program. ■ 



Regent 



REGENT BASE 

A FULL FUNCTION 
RELATIONAL DATABASE 
Regent Base's procedural language 
make it a natural for handling any of your 
small business needs. Modules are 
available tor Invoicing, Accounts 
Receivable, Checkbook Balancing, 
General Ledger, etc. 
Regent Base Is a relational database 
written specifically for the Atari ST Don't 
settle tor simple clones of IBh/l products. 
Regent Base is easy to use and state-of- 
the-art! 



REGENT SOFTWARE 

7131 Owensmouth, Suite 45A 
Canoga Park, CA 91303 
(818)883-0951 



ATARI ST! 



■ I I 




Multi-Forth 

l^ lie (\u^ $T 

A Professional Development Language 
for the 520 and 1040ST 



Turnkey Compiler - No Royalties 

GEM and TOS Support 

Multi-taslsing 

Floating Point 

CompuServe Support - GO FORTH 

Built-in Assemijler 

Use Standard Text Files 

400 Page User's Manual 

Compatible with other CSI Forths 

Shipping Now - $149 Intro Price 



1-800-FORTH-OK 

Creative 
Solutions, Inc. 



4701 Randolph Rd.. Suite 12 
Rockville.MD 20852 
in MD 301-984-0262 



Mat;FORTH & Mulli-Forlh are Lrademarks of Creative Solution' 
Atari ST is a trademarlc of Atari Corporation 

CIRCLE Dli ON READER SERVICE CARD 



CIRCLE 100 ON READER SERVICE CARD 



PARSERS, 

ROOMS, 

OBJECTS 

AND 

TROLLS 

THE 

ADVENTURER'S 

TALE 

by Alex Leavins 




■ he author of the 8-bit Atari text adventure, 
Wombats, reveals how to create text adventures in 
C. Includes an analysis of mapping, parsers and 
object manipulation — plus a "mini," five-room text 
adventure which you will discover within the 
ADVENTUR.STQ folder on your START disk. 
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"/ stood there, breathing 
heavily. The troll 
regarded me with two 
ugly yellow eyes, swing- 
ing its mace suggestively. 
I hacked away, feinted, 
and as the mace whistled 
by my ear, smote the 
troll with my sword. It 
vanished in a puff of oily 
smoke. The jewels were 
mine, I advanced. . !' 




Most readers will recog- 
nize this as part of a text 
adventure, an interactive 
book, in which the computer acts as 
guide, referee, scorekeeper and adver- 
sar}' in an alternate -and often quite 
complex-world, a world that exists 
only inside the computer itself. The 
rules are not always clear; and combat 
(if there is combat) can prove fatal. But 
don't worry- there's alvi^ys the Reset 
button. 

A typical adventure -game interplay 
between computer and player might 
read like this; 



You're standing in a small room; a 

sputtering torch is on the wall. 

--> TAKE TORCH 

OK, you now have a torch, 

-->EXAMINE TORCH 

It's just your basic torch, 

-->NORTH 

You're standing in a long corridor 

with exits to the south and west. 

-->EAST 

You can't go that way 

-->WEST 

This is the end of the corridor You 

can go east from here There are 

some jewels here. 

-->TAKEJEWEl^ 



Taken. 

-->EXAMINE JEWELS 

They're beautiful gemstones, agates 

and diamonds, 

The — > is a prompt telling the 
player to enter a command. The upper- 
case words represent the player's input, 
and the computer's responses are 
shown in lower case. In our example, 
the computer prints a location descrip- 
tion, "This is the end of the cor- 
ridor , ,," followed by the — > and 
waits, The player then types TAKE 
JEWELS. The computer tries to recog- 
nize the input and take the appropriate 
action, in this case, taking the jewels. ► 
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PARSERS... 



OK, we've got a basic understanding 
of what an adventure game is. Now, 
how do they work? 

BUILDING A UNIVERSE 
CAN BE TOUGH 

We're going to create a simple text ad- 
venture in C, which you will find on 
your START disk within the folder 
ADVENTUR.STQ Refer to the Disk hv 



can travel to, then it's a room. All oi the 
rooms in our gime, taken all together, 
make up the game's universe. Here's the 
universe for the simple adventure game 
that we'll be building (see Figure I). 

Here we have five rooms, each of 
which leads to at least one other room- 
{Rooms aren't ver)' useful if you can't get 
to them.) Going east from the Open 
Forest room (room #1) will take us to 
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FIGURE 1 

struction page for further information. 
We have no bells and whistles in this 
program, no GEM, no graphics-just the 
essentials: five rooms, some objects, 
and a two-word parser Once you 
understand this structure, you can ex- 
pand upon it, and perhaps create your 
own Infocom-style ^me. 

Let's ignore for a minute just how 
our program will interact with the 
player This is not a trivial matter but 
belore we can address it we must first 
determine what the ^me itself is going 
to do. Every adventure game includes a 
number of discrete locations, known as 
rooms. Room is a generic term, referring 
to any distinct location in the ^me. It 
needn't be inside a building, indeed it 
needn't even be enclosed. If it's a 
unique, specific location that a player 



the Forest Edge room (room #2). Simi- 
larly, going south from the L^rge Rock 
room (room #4) will take us to the 
Dense Forest room (room #5), We can 
summarize all of this as in Figure 2. 
So, north from room #3 leads to 
room #2. South leads nowhere, as does 
east, and finally, west will take us to 
room "4. The rows give us the direction 
we wish to move in, the column head- 
ings give us the room we're currently in. 
If we're in room #4 and want to move 
north, we look in the NORTH row, 
under "room #41' and discover the 
number 1, which is the Open Forest 
room. Ah, but what if we don't find a 
room number, but a zero? Easy Zero 
means for that room, that direction 
leads nowhere By the way, you'll note 
that going north from room #1 leads 



to-room #1! This often happens in ad- 
venture games; rooms will double back 
on themselves, lead to rooms way on 
the other side of the universe, or other, 
nastier surprises. 

If you'll look at the code of ADVEN- 
TUR.C on your START disk, just before 
main(), you'll notice that I've translated 
the above table to a series of integer ar- 
rays, containing room values. We have a 
north, south, east, and west array, cor- 
responding to the four directions. 
Movement for our program is just as 
simple as the table; northfl] is the 
room we'll reach if we walk north from 
room #1. 

This is implemented in the routine 
move_usC). This routine takes a direc- 
tion (n, s, e, w) and a current position 
(the room the player is in), and deter- 
mines what room (if any) the player 
ends up in. It does this by a simple 
switch on the desired direction, which 
then routes the current room into the 
appropriate directional array The 
capitalized versions of NORTH, 
SOUTH, EAST and WEST are defines 
contained in the file GAME.H, which 
represent 1, 2, 3, and 4, respectively Af- 
ter the switch, the value of i is either the 
room that the player is now in, or zero. 
It it is zero, we know the player can't go 
in that direction, and a simple test fol- 
lowed by a printf statement lets the 
player know this. If the move is valid, 
we show the player the new room and 
any objects that might be there 

Ah. objects. Haven't mentioned those 
yet, have I? 

THE CARE AND 
FEEDING OF OBJECTS 

The universe of rooms is one building 
block of adventure games. Objects are 
another. Briefly, an object is any item 
that can be seen, taken, used, or inter- 
acted with in any other way Objects in 
sophisticated adventure games can have 
many properties. For example, not all 
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objects seen in a room may be "takea- 
ble!' while some takeable objects may 
not be revealed in the original room 
description. Complex, eh? Don't worr}', 
in our adventure ^me, an object is eas- 
ily spotted by the phrase: 

There is an XXXXX here" 
where XXXXX is the object in question. 
In our game there will be four objects: a 
book, an axe. a coin and a stick. Each of 
these will be in a different room, and 
can be acted upon in several simple 
ways. We will be able to take an object, 
drop it, examine it. read it, even throw it- 
Each of these commands is im- 
plemented by a separate routine. Obvi- 
ously, take_object(). takes objects. 
Each of the other routines is similarly 
named, except exam_object, which is 
shortened to prevent a seven-character 
label-name conflict. 

The basic procedure for each of 
these routines is the same. First, deter- 
mine the command requested by using 
the switch(cmd_index) statement in 
main{ ), Next, find out if the word fol- 
lowing the command is a valid one, 
with split_word(), which separates the 
succeeding word from the input string 
and puts it into a test array, and scan_ 
objectsO, which tests the word in the 
test array against the objects that the 
^me recognizes. If the object is one that 
the game knows, the program attempts 
to process it. using the appropriate 
xxxx_object routine If the object is not 
recognized, then the game prints a short 
message and waits for the next input 

So far, I've avoided the issue of how 
the computer recognizes words. This is 
the third major aspect of adventure 
games, and is known as the prn'^ci: 

PARSERS, OR WHAT'S 
THAT WORD? 

W'c now have some undci"standing ol 
the low-level routines that process game 
procedures, such as the taking of ob- 
jects. But how do we get from the player 



typing 'TAKE BOOK" to actually taking 
that book? 

Obviously, a computer doesn't 
"know" words, it can only process 
numbers. We need a way of translating 
the user's input into simple numerical 
values-or tokens-that the ^me can 
use fo determine what happens. This 
translation process is performed by the 
game's parser, which takes words and 
sentences, breaks them down, analyzes 
them, and cokenizes them by assigning 
a unique number to each command. 
The array commandstl and the array 
objectsll (just before main()) contain 
all the words that our game will 
recogn ize : 

COMMAND TOKEN OBJECT TOKEN 

NORTH I BOOK I 

SOUTH 2 AXE 2 

EAST 3 COIN 3 

WEST 4 STICK 4 

TAKE 5 

DROP 6 

THROW 7 

READ 8 

EXAMINE 9 

INVENTORY 10 

LOOK 11 

QUIT 12 



Notice that these are the actual 
words that the ^me recognizes; they 
are literal strings. The computer recog- 
nizes these words by their token num- 
bers, which are actually the positions of 
the words within the commandll or 
objectll arrays. Notice also that the file 
GAME.H contains each of these words 
m a deline statement: 

#define NORTH 1 
#define SOUTH 2 
#define etc. 

Here the words are actuall)' labels that 
are replaced with the corresponding 
numerical values at compile time. So 
there are two versions of the same 
word, both related to the same number, 
but seen differently by the program. 
Why do we do this? There's a very good 
reason- it's just a little confusing at first. 
Let's go back to our parser. We want 
it to accept a word or two of input, such 
as NORTH, then translate that into a 
numerical value, such as 1, so that the 
program can do something like: 



if(command_vaIue = 



1) 



. /* move the player north */ 



From: 


room #1 


room »2 


room #3 


room #4 


room « 


North 


1 





2 


1 


4 


South 


4 


3 





5 





East 


2 








3 





West 





1 


4 
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Take a look at that if statement. 
Without the added comment, the code 
isn't particularly obvious, is it? What 
does the 1 mean, anyway? But now 
suppose we do this: 

#de(ine NORTH 1 



if(command_value == NORTH) 



. /* move player north */ 



1 



This makes things much clearer to 
someone reading the code, and makes 
the code a whole lot easier to write. We 
can now reference, in the code, the ac- 
tual command tokens that were created 
by the parsing language. We can build 
the entire adventure game, and use the 
command and object names that the 
game itself recognizes, without having to 
reference the token values of a com- 
mand or object, 

OK, enough of tokens, objects, and 
rooms. Let's get to the heart ol the mat- 
ter: the parser 

PARSING AGAIN, OR 
ENGLISH MADE SIMPLE 

The player has just typed "TAKE 
BOOK" and is eagerly awaiting a re- 
sponse. OK, what's the first word? What 
do you mean, what's the first word? It's 
obvious. TAKE is the first word. Ah, but 
it's not obvious to the computer, which 
sees language as just a string of bits. But 
it's easy to define a "word" for the com- 
puter A word, in this case, is any text 
string, followed by a blank space. So, in 
the following sentence: 

TAKE THE GHSTS AND THE BOOK 

TAKE, THE, GHSTS, AND, THE, and 
BOOK are all words to the computer- 
even though GHSTS is no word that I 
know. With our simple dehnition of 



"word;' scanning the input string and 
separating it into discrete words be- 
comes simple. It is implemented in the 
routine split_word(), by scanning the 
input array, parserll, and looking for ei- 
ther a blank space, or the end of the ar- 
ray (since the last word in a sentence 
won't have a space after it). Once the 
blank space is found, ever)'thing is co- 
pied from the start of the array up to 
that space, into the array test_word. 
Now, shift the remainder of the array a/- 
lev the space, to the start of the array so 
that the next time we examine the array 
the next word will be at the beginning. 

We now have the first word of the 
player's command, TAKE, in the array 
test_wordll. We next pass it to scan_ 
commandsO, which will test it against 
the list of known words. You'll note that 
the array commandsll contains all our 
command words, with each one sepa- 
rated by an asterisk. The asterisk is 
used as a delimiter so that scan_ 
commands()can tell where one word 
ends and the next one begins. We use 
the pound sign (#) to tell the routine 
that there are no more words. 

The scan_commands( ) routine it- 
sell is very simple. Read a command 
word into the test array showwordll, 
then do a string comparison between it 
and the word in array test_wordn. If 
the result is zero, the strings are identi- 
cal and the routine returns the index of 
the word, which is the position the 
word occupies in the array com- 
mandsll. If the result is not zero, the 
routine tests to see if we've exhausted 
our word list. If not, then the word in- 
dex is incremented, and the next word 
is read Into the array showwordll. If we 
have exhausted the list of words in 
commandll, we exit the routine with a 
returned value oi zero, which tells the 



main routine that we didn't recognize 

the word, 

PUTTING IT ALL 
TOGETHER 

We now have all the pieces we need to 
put together an adventure game Let's 
walk through the entire procedure for a 
single command, to get a feel for how it 
all works. We'll examine how the adven- 
ture game processes the command: 

TAKE BOOK 

Staning at the top of the WHILE (1) 
loop in main(), we first execute get_ 
inputC), which simply waits for the 
player to type a string into the array 
parserll. Note that if the player simply 
presses [Return] without typing any- 
thing, the ^me displays a brief "Say 
what?" message, and recycles through 
the keyboard -input routine. 

The player types TAKE BOOK, and 
get_input() returns with the string 
TAKE BOOK in the array parserll. Now, 
we call split_word(), which breaks the 
first word, TAKE, out of the array 
parserll, and puts it into the array 
test_wordll. It then shifts the string in 
parserll over, so that parserll now con- 
tains the string BOOK, Now tesl_ 
wordll contains the string TAKE. Next, 
we call scan_command( ) which com- 
pares the words NORTH, SOUTH, 
EAST, WEST, and TAKE to the word in 
lest__ wordll. On the fifth pass through 
the loop it finds a match in the word 
TAKE, and returns the number 5, which 
is put into the variable cmd__index. 

Now the program tests the value of 
cmd_index. Zero would mean the 
player had typed a command that the 
program didn't recognize, and the mes- 
sage "I don't understand that com- 
mandr would be displayed before it 
returned to the top of the WHILE (1) 



STakt, the ST Quarterly 



loop. However, in our case crnd_index 
equals 5, so the program passes it to 
switch(cmd_ index), where case TAKE 
will be executed, (Remember, we've de- 
fined the word TAKE to be 5, in 
GAME.H.) 

The first thing the program does in 
the case statement is call split_word() 
again. Now the word BOOK is shifted 
into the array test_wordll, leaving the 
array parsertl empty Then the program 
calls scan_objects(), which does for 
objects what scan_commands( ) does 
lor commands. It scans through the list 
of objects in the game to match them 
against the test word. In this case, 
scan_objects( ) tests the word BOOK, 
finds a match, and returns a value of T 
which is put into the variable obj_ 
index. The program then tests the value 
of obj_index to see if it is a recognized 
object. If not, the program will print ''I 
don't know what that is," and exit to the 
top of the WHILE (1) loop. In our case, 
it did recognize the word, and so passes 
its index to take_object(), which per- 
forms the actual taking of the object. 

Notice that up until this point the 
only thing our parser has done is to 
break down the input of the player, and 
process it to find out what to do with it. 
No "game" actions have taken place. It's 
only now that the program can invoke 
any of the game mechanics themselves, 

TAKING THE OBJECT 

The program has passed to take_ 
objectO the index of the item the player 
wants to take. Note in GAME.H that 
we've defined: 

#deftne BOOK 1 
#define AXE 2 
#define COIN 3 
#define STICK 4 

The [irst statement in take_ 
object()is an IE statement, which says: 



IE (inventorylobjj EQ ON) THEN 
printfC'You "ve already got 
it!\n'0; 

But what's inventory? Since the pro- 
gram needs some way to determine, at 
any time, what the player is carrying, we 
implement this in a simple fashion with 
the array inventorytl. The value of nth 
element ofinventoryll tells the program 
if the player is carr)'ing the nth object. If 
the value is zero, or OFE the player isn't 
carrying the object, but if the value is I, 
or ON, the player is. Thus, to see if the 
player is carrying the BOOK (which has 
an index value of 1), the program looks 
at inventorylll. 

The IF test now becomes clear: If the 
player is already carrying an object, it 
can not be taken a^in. Assuming the 
player is not carrying the BOOK, the 
next statement, 

ELSEIE (wherelobj! NE position) 
is executed. The array wherell works 
exactly the same way as the inventoryll 
array, except that the wherell array de- 
fines what room an object is currently 
in. So if whereOl equals four, the third 
object (in our game, the COIN) is cur- 
rend)' in room #4 (in our game, the 
1-arge Rock room). If some value of 
wherell is zero, the related object is in 
the player's possesion. Note that this 
ovedaps the inventory function. 'We 
could, if we wanted, use the wherell ar- 
ray to define both the placement of ob- 
jects in the universe, and objects cur- 
rently in the player's possesion. But it is 
much simpler, conceptually, to have two 
separate arrays. 

The variable position defines the 
current position of the player If the ob- 
ject the player is trying to take is not in 
the same room,the player can hardly get 
it. But if we assume the book is in the 
room, the program sets wherelobj) to 
OFF, indicating that the object is no 
longer in a room, then sets inven- 
torylobj] to ON, indicating that it's in 



the player's possession. The program 
then prints a message that the player 
has taken the object and exits the rou- 
tine. Back in main(), we've reached the 
last statement in case TAKE: and we're 
done with our example. Ta-da[ 

ENHANCEMENTS 

Adventure g^mes are great fun to build, 
but can be frustrating because there's al- 
ways still one extra feature that's just too 
good to leave out. Here are a few ideas 
for improving our litde adventure ^me 
(aside from enlarging its universe). I'm 
sure you can come up with many 
others, 

• Increased vocabulary- Obviously 
an adventure game is only as good as 
the words that it can handle Some ad- 
venture games handle a few hundred; 
others, such as Infocom's, handle more 
than a thousand. A bigger vocabulary 
also creates a much better illusion of 
reality 

• Belter semantic and syntactic 
handling of English- Our adventure 
^me uses a simple verb/noun parser 
limited to either one- or two-word com- 
mands. Wouldn't it be nice to have it 
recognize such things as: 

DRAGON, GIVE THE RARE 
BOOK TO THE ANGRY TROLL 

All of this is possible, but would require 
at least a thorough understanding of the 
elements of English sentences. If you're 
serious about building a better parser, I 
recommend that you first acquire fur- 
ther information on the syntactic rela- 
tionships of words (see Reference, be- 
low). As an example of the kinds of 
things you'll have to consider when 
designing your parser, here are two sen-^ 
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tences that are semantically identical 
(they mean exacdy the same thing) but 
syntactically quite different: 

GIVE THE BOOK TO THE ALIEN 
GIVE THE ALIEN THE BOOK 
Both sentences have the same result: 
the alien is given the book. But the di- 
rect and indirect objects are exactly 
reversed, and the word TO is missing in 
the second sentence. 

• More complex objects- Wouldn't 
it be nice to give each object a variety ol 
characteristics, such as weight, size, visi- 
bility (objects might appear only after a 
player has done some other task first), 
"takeability" (which would define 
under what circumstances you could 
take an object), and many other thin^, 
Something like this could perhaps be 
implemented using a structure. For 
example: 
struct object = i 

int weight: 

int size; 

int take; 

int visible; 

I; 

might define the weight, size takeability 
and visibility of an object. Then we 
could define objects simply, in terms ol 
the generalized structure. Every object 
would have the same set of possible 
properties and we could build a more 
complex game without a great deal 
more work, 

' Frames- A concept from the ar- 
tificial intelligence lield, a 'Trame" is a 
set ol default conditions. Suppose we 
made the default condition for all ob- 
jects as takeable We would then only 
have to dehne-or flag-those objects in 
the ^me which were not takeable By 
establishing a default condition covering 
the majority of situations, we efiminate 
a lot of code we would have had to ap- 
ply to each individual object. Applied 
throughout the g^me, this concept can 
save a great deal of coding time. But 
keep in mind that, once programmed, 
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default behavior cannot be changed. 

• More text- Wouldn't it be nice to 
describe ever)' room with a whole 
screenful of rich, imaginative text? In- 
stead of printing a simple one line 
string for each room, we could open up 
a text file corresponding to the room 
number and read in as much text as we 
wanted. We could apply this concept to 
everything, not jusc rooms, so chat a 
great many acdons would yield interest- 
ing, non-trivial results. Or, how about 
placing pictures instead of text in our 
nies? 



• Independent characters- How 
about characters that walk around the 
universe independent of you and help 
or hinder your progress, depending 
upon your interactions with them? 

How about. . ., but it's pointless, I 
could go on for days. Suffice it to say the 
ultimate adventure game has not yet 
been wntten. Up to now, we have seen 
only the fledghng first steps of a whole 
new artform. With patience, persistence, 
and a licde bit of luck, you might enlarge 
the five rooms in our sample program 
and help shape the future of adventure 
gaming. H 
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Comparisons are odious-and 
often misleading. This is espe- 
cially true of programming 
languages. No matter what yardsticks 
are used, certain elements of the test are 
bound ro be unfair to various im- 
plementations. But language compari- 
sons provide necessary and valuable 
guidelines lo both the serious developer 
and the dedicated hobbyist. 

One way to compare C's is to first 
determine the features of the "perfect" 
compiler then find a way of evaluating 
these features objectively. Easier said 
than done. A number of tests, called 
"benchmarks;' have been developed to 
quantify these features. The best 
known -the Sieve of Eratosthenes - 
measures a compiler's ability to 
manipulate several variables rapidly. But 
benchmarks often do nor accurately 



^^TART compares the four available ST C lan- 
guages: Alcyon, Lattice, Megamax, and GST- 
including revealing benchmarks plus a critical anal- 
ysis of each compiler's methods, documentation, 
editors, and extras. 



measure what they appear to measure 
For example, the following code was 
once used to measure a compiler's abil- 
ity to manipulate pointers: 

strlenCs) /* returns the length of s */ 
char *s; 

I 

char *p; 

for(p = s; *s!= '\0'; s+ + ) ; 

return(s — p); 



This really tests the efficiency of the for 
loop. The amount of time spent doing 
pointer manipulations is trivial com- 
pared to the time spent executing the 

loop. 



Disdnguishing between a compiler 
that generates good code and one that 
uses an efficient library is important. If 
you rarely use library calls, a poor com- 
piler with a fast library is not the one 
for you, 

DHAMPSTONE 

01 all the generic benchmarks pub- 
lished over the years, the best we have 
seen is Dhampstone, by Jack Purdum. 
Dhampstone, first published in the 
February, 1986 issue of Computer Lan- 
guages, is actually several benchmarks 
in one. It avoids library calls and does a 
good job of testing specific features of a 
compiler- And all of Dhampstone's 
subroutines return a value which helps^- 



STakt, Ihe ST Quarterly 



63 



C FOR ME... 



the programmer verify if the compiler 
generates correct code We added tim- 
ing routines for the GST C test and 
modified the program to run on the 
Atari ST. (Look in the BENCHMRK STQ 
folder on your START disk for the 
Dhampstone source code.) In all cases, 
each compiler returned the correct 
values from the subroutines, so no indi- 
cation of the returned "magic" numbers 
is included in our charts. 

The pecuhar name for this bench- 
mark is a tongue-in-cheek reference to 
two other benchmarks. The Whetstone 
benchmark is a well-known measure of 
floating-point performance from the 
mainframe wodd, and the Dhrystone 
benchmark, written by C, Weicker, and 
pubhshed in CACM (Communications 
of the ACM ma^zine), is based on a 
study of keyword frequency in pro- 
grams written in several different lan- 
guages. The Dhrystone benchmark at- 
tempts to show the distribution 
frequency of these keywords. Purdum, 
however, made a similar study of key- 
word distribution directed specifically 
at C in some 15,000 lines of C code 
from the Digital Equipment Corporation 
User's Group in Marlboro, Mas- 
sachusetts. He found significant differ- 
ences in C keyword distribudon from 
Weicker's study. The Dhampstone 
benchmark reflects Purdum's findings 
for Cs keyword distribution. It includes 
tests of string handhng, arithmetic in- 
volving integers, unsigneds, longs, dou- 
bles, and disk 1/0, The unsigned test 
also checks a compiler's ability to han- 
dle recursion by finding Fibonacci 
numbers (a series in which each num- 
ber is the sum of the previous two, ie , 
1, 1, 2. 3, 5, 8, 13, etc). While these are 
simple trials, they do a good job of test- 
ing a compiler in its critical tasks. 

DOODLE 

To test GEM compatabiUty, we used 
DOODLE, the paint program included 
with the Developer's Toolkit. This is a 



good example of a typical GEM applica- 
tion in terms of size and usage It also 
revealed some interesting violations of 
programming standards. For example, 
Alcyon C will allow a pointer to be as- 
signed to a nonzero constant or to a 
variable. Kernighan & Ritchie 
specifically forbid this. With the pickier 
compilers, such as Me^max, it causes 
portabihty problems. It also uses long 
integers as pointers. 

The greatest portability concern we 
encountered resulted from the lack of a 
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standard size for an Integer variable Lat- 
tice and GST use a 32-bit integer; Al- 
cyon and Megamax use a 16-bit integer 
Both the new ANSI standard (see be- 
low) and Kernighan & Ritchie define an 
integer size as the "most convenient" 
size for a particular machine Histori- 
cally integers have been the same size 
as pointers, but there is no real reason 
they should be, especially since making 
integers the same size as pointers tends 
to promote programming abuse Since 
the 68000 is a 16-bit processor and 32- 
bits requires two memory fetches, we 
have to agree with Alcyon and Megamax 
in choosing 16-bits for the default size 

The quickest way to categorize the 
available ST compilers is to decide if 
you need a simple compiler or a full 
GEM developer's kit, Alcyon and Mega- 



max offer GEM developer's kits which 
include resource construcdon sets and 
full GEM documentation. Lattice and 
GST are compiler packages. They can be 
used to produce GEM apphcations, but 
with more difficulty 

Among these products, there are as- 
tounding differences in the compile and 
link times, and the size of the executa- 
ble programs. One reason GST's size on 
the Dhampstone is so much larger is 
that it always includes code for win- 
dowing. Megamax's dmes are so much 
quicker because it is a single-pass com- 
piler and doesn't have to wait on disk 
I/O for intermediate files. 

In evaluating each compiler, we have 
tried to identify the best features of each 
and express its basic "feel" We have left 
most of the performance evaluation to 
the benchmarks (see our accompanying 
charts). The quantitative differences be- 
tween the compilers are quite disdnct. 

ANSI 

Recently, the American Nanonal Stan- 
dards Inshtute (ANSI) established the 
X3J11 committee to define a standard 
for the C language. In addition to clarify- 
ing many ambiguities in C as defined in 
"The C Programming Language" by Ker- 
nighan and Richie, the committee has 
added several new features to the lan- 
guage which are beginning to show up 
in new releases of C compilers. These 
include the "void" data type for func- 
rions which don't retum significant 
values, enumerated data types, structure 
assignment, the use of "unsigned" as a 
modifier for other data types, and per- 
haps most importandy, function pro- 
totyping. 

A frequent source of errors can be 
traced to adding or deleting arguments 
to functions and failing to make corre- 
sponding changes to all of the calls to 
those functions. In the past, C com- 
pilers have blithely compiled such er- 
rors without complaint. On the first call 
with mismatched parameters though. 
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the program suddenly begins executing 
parameters or passing code-with disas- 
trous results. Function prototypes allow 
the programmer to declare the number 
and type of a functions parameters, and 
the type of its return value With this 
information the compiler can detect 
and warn of mismatched parameters. 
Lattice C implements all these ANSI ex- 
tensions. Its function prototyping allows 
it to detect the wrong number of 
parameters, and it will complain if you 
pass a pointer to an int instead of an in- 
teger However, it remains silent if you 
pass a char m an int; it would be nice if 
the type-checking here were sirictei: 

FLUCTUATIONS 

As dynamic as the ST is, it is hardly 
surprising that, within the time this re- 
view was written, one C compiler had 
been withdrawn from the market and 
one was being introduced. Our review 
will cover the four compilers that are 
currently being marketed: lattice, Al- 
cyon, Megamax, and GST. Many people 
are familiar with Hippo-C from Haba 
Systems. We talked with Pat Merrifield 
from Haba and he informed us that 
Hippo-C is no longer being marketed by 
Haba Systems, Hippopotamus Software 
originally developed Hippo C for in- 
house use, Haba Systems purchased the 
rights from Hippopotamus to finish and 
market it. Haba subsequently released 
it, but after receiving a Rood of error 
reports, withdrew it from the market. 

On a more positive note, Mark Wil- 
liams, of Mark Williams Company, 
manufacturers of Let's Write, indicated 
that he is developing a C compiler for 
the ST. Unfortunately it was not ready in 
June 1986, when this article was writ- 
ten. Mark Williams is well known in the 
wodd of minicomputers. He also has a 
compiler on the IBM PC which is one of 
the few available on a microcomputer 
with a source-level debugger START will 
examine this compiler package when it 
becomes available. 




LATTICE C 

Anyone who has worked with C in the 
MS-DOS environment will recognize 
and welcome Metacomco's introduction 
of Lattice C to the Atari ST marketplace. 
Although Microsoft C is currently 
challenging Latdce C for market leader- 
ship on the IBM PC, it is probably safe 
to say that more applications have been 
written with Ljittice C than any other 
MS-DOS C compiler Thus, the Atari ST 
version of Lattice C will particularly 
interest anyone considering a port of an 
MS-DOS application to the ST. 

Lattice's recent 3.0 release for MS- 
DOS was a major upgrade from the 2.x 
versions in two areas. It added the new 
ANSI C language extensions, and in- 
cluded an improved, more UNIX- 
compatible library We were glad to see 
that the ST version included the ANSI 
extensions. This indicates to us that the 
compiler portion of the ST product is 
Lattice's newest and best. The library, 
however, is definitely the equivalent of 
the older 2.x MS-DOS library rather 



than the newer 3.0 release. This really 
amounts to saying that the library is 
merely very good instead of being excel- 
lent. The function index for this im- 
plementation has more than 130 entries 
covering memory allocation, I/O, utili- 
ties, string handling, and math 
functions. 

DOCUMENTATION 

Documentation for Lattice C consists of 
a paperback manual of about 250 pages. 
It includes a two-page table oi contents, 
five appendixes, and an eight-page in- 
dex. Two of the appendixes thoroughly 
document error messages and even sug- 
gest possible sources for the errors. The 
remaining appendixes include example 
programs, a funcrion index, and 
documentation of the GEM VDI/AES 
interface. The manual itself contains 
sections on the editor, the linker, the 
language definition, and machine de- 
pendencies in the code generation. The 
bulk of the manual-a full half of it-is 
devoted to UNIX-style documentation 
of the library. Each library function has 
Its own page with sections explaining its 
purpose, giving its synopsis and descrip- 
tion, specifying its return valueCs), and 
noting any relevant cautions. 

A major weakness in the manual is 
its documentation of the VDI/AES inter- 
lace, which is relegated to a 16-page ap- 
pendix. Each entry includes a routine 
name plus a short phrase describing its 
action. Arguments for the routines are 
listed, but not the argument types or 
legal values. This appendix seems in- 
tended only as a guide to the heavily 
commented assembly-language source 
code for the VDI/AES calls, provided on 
the disk. Although the source provides 
much more information about argu- 
ments and how to use the routmes, the 
information is still woefully inadequate 
by itself 

GEMDOS, BIOS, and XBIOS calls al- 
low access to machine-specific parts of 
the ST operating system. These vital in-^ 
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tei'latc roucines arc documented by Lu- 
tice with only a single page each. But it's 
hard to fault Metacomco for this poor 
documentation when the blame should 
really be placed at Atari's door VDI, 
AES, and rhe GEMDOS, BIOS, and 
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XBIOS should be thoroughly docu- 
mented in a series of manuals available 
from Atari at a reasonable price. To 
make this information available only to 
developers, and only with $300 worth 
of bundled software is unprofessional 
and counterproductive. IBM has set a 
standard for thorough and freely avail- 
able documentation that Atari would do 
well to follow. 

USE 

Creating an executable program with 
Lattice C is a two-step process. First, 
you invoke the compiler-driver, LC, 
which opens a dialog box prompting 
you for a single file name and any com- 
mand line specifiers you wish to use. 
LC, in turn, executes the two phases of 
the compiler: LCI, which parses the 
source and outputs a quad file, and LC2 
which generates the code. The second 
step is linking, using the GST linker thai 
Metacomco supplies, A^in, you use a 
dialog box to pass a command line to 
the linker The linker is identical to the 
one Included in the GST C package. 

Several compile-time options can be 
specified when running LC. You can re- 



direct error and warning messages to a 
specified file by using >filename. The 
— dsymbol or —dsymbol = value op- 
tions define the identifier "symbol"' 
This can be used to trigger conditional 
compilation directives in the code 
(#ifdef, #ifndef, etc.). Although the de- 
iault effective length for identifiers is 
eight characters, you can override this 
with the -n option which causes the 
compiler to use up to 31 characters to 
differentiate identifiers. Stack overflow 
bugs can be extremely difficult to diag- 
nose. The -p option causes the code 
generator to insert a special instruction 
known as a "stack probe" at the entry of 
each function. If the stack overflows, 
this code detects it and aborts the pro- 
gram with a "stack overflow" message. 
Alter you're sure your code is clean, you 
can recompile without the stack probe 
option. This can save you hours of 
debugging. The -i ophon is useful for 
specifying in which directoiy the com- 
piler should search for #inclucle files 

EDITOR 

1 he editor pro\'ided with fj^ittice C is 
sen'iceable. It's not mouse-oriented, nor 
does it support windows, but it does al- 
low the basic text manipulation neces- 
sary for program editing in a straightlbr- 
ward way The Control key handles the 
more frequently used commands 
Other, extended commands, are typed 
on a command line at the bottom of the 
screen alter pressing the Esc key. The 
default size of the text buffer is large 
enough to edit a file of about 60K. A 
command-line option is available for 
larger files. 

EXTRAS 

Unlike ihc GST and Alcyon compilers. 
Lattice C includes no assembler Unlike 
the Megamax compiler, lattice C in- 
cludes no disassembler It makes no 
provision for inspecting code generated 
by the compiler, nor for optimizing it by 
hand. The calling protocol lor assembly 



routines is clearly documented, as is the 
protocol for calling a C function from an 
assembly language module 

Up to eight variables may be 
declared register variables. The compiler 
reserves four address registers for 
pointer variables and four data registers 
lor simple variables. A peculiarity of 
this compiler is that integers are 32 bits 
long- the same size as longs. This cre- 
ates relatively larger and slower code. 

The compiler, linker, editor, and 
other necessary files take up about 
293K of disk space. If you're using one 
single-sided drive, this doesn't leave 
much room for source. At least one 
double-sided drive or two single-sided 
drives are necessary to use this com- 
piler effectively 

SUPPORT 

Metacomco, a British company, supplies 
an address in Scotts Valley, CaJifornia 
for customer support, as well as their 
home address in Bristol, England, We at 
first suspected the California address 
would be essentially a marketing center, 
but were surprised to find real technical 
assistance at the other end ol the phone 
line 

CONCLUSION 

Lattice C represents an excellent value 
for the price- The mature compiler and 
its compatibility with the foremost MS- 
DOS compiler makes it an attractive 
package. The documentation is clear 
and nicely presented. Compared to Al- 
cyon C, its compile and execution times 
are very respectable. 
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ALCYON C 

We bought our Atari STs with the inten- 
tion of developing and seUing software 
At the time, the only software tools 
available were bundled in the De- 
veloper's Toolkit, available from Atari for 
$300, Although there are now alternate 
choices, the bona fide software de- 
veloper who intends to bring a product 
to market will find the developer's pack- 
age indispensible The tools aren't the 
best, and the documentation leaves a lot 
to be desired, but they suffice to get the 
job done. Plus, Atari wants you to suc- 
ceed in your product development; 
quire often rhey are able to assist you 
with your marketing efforts. 

DOCUMENTATION 

The developer's package includes a 
compiler and assembler from Alcyon; a 
linker debugger, and various utilities 
from Digital Research, Inc. (DRl); and 
an editor, telecommunications package 
(Kermit), and other utilities from Atari, 
The documentation consists of a six- 
inch-plus stack of over 2,000 double- 
sided loose sheets. The principal parts 
of the documentation are a several- 
hundred-page GEM Programmer's 
Guide, a "Hitchhiker's Guide to the 
BIOS!' the "Long-Awaited Line A' Docu- 
ment!' a GEMDOS manual, and 
CP/M68K documentation for the com- 
piler, linker, debugger and utilities. The 
CP/M68K documentation is indexed 
and includes extensive tables of con- 
cents, but it also contains much that 
pertains only to the CP/M68K environ- 
ment and must be disregarded, in short, 
the information is (probably) al! there. 



but there's a lot of chaff with the wheat, 
and you'll find j'ourself domg a lot of 
silting. 

The package includes sample pro- 
grams plus two excellent examples that 
help answer many GEM-relaied ques- 
tions. ACCSKEL.C and APPSKELC are, 
respectively, skeletons for desk accesso- 
nes and for GEM applications. Add 
your code and you're on your way. The 
hard part of hooking up with GEM is 
done for you, 

it's been our experience that working 
with new equipment means using 
Xeroxed, poorly-orgmized documenta- 
tion, tools that don't work well together, 
and having to figure out a lot of things 
on your own. That certainly is the case 
with the developer's package It was per- 
haps justifiable a year and a half ago 
but, unfortunately, il is still true today !t 
is time we start to see typeset, indexed, 
organized documentation, and tools 
with more polish than is currendy be- 
ing offered b)' Alcyon, Dlil and Atari. 

USE 

The Alcyon compiler consists of four 
pieces: cp68, the preprocessor; c068, 
the parser; cl68, the code generator; 
and as68, the assembler A batch-file 
utility invokes these components, 

Alcyon supports many of the same 
compile-time options that the Lattice 
compiler does, -dsymbol, and — idir 
work the same way — e specifies the 
use of IEEE floatingpoint format. This 
supports single and double-precision 
floatingpoint, —f specifies Motorola's 
"Fast Floating Point" format which sup- 
ports only single precision. 

The Developer's Toolkit provides an 
alternate environment for program de- 
velopment. If your tastes run more to 
traditional shells, you may prefer COM- 
MAND,TOS CO GEM, Invoke it, and you 
will see a bare ja) prompt. The com- 
mands are not documented, but if you 
are familiar with UNIX and MS-DOS. 
the)' are what you would expect. Wc 



use COMMAND.TOS frequently with 
the De\'eloper's Toolkit. Constantly 
growing and shrinking windows can 
become obnoxious after a while, and 
dialog-box command lines seem to be a 
clumsy way to start up a coinpiler 

Two additional tools are unique to 
this compiler and are invaluable, nm68 
is a utilicy similar to the UNIX nm. It 
takes a ".O" file as its input and prints 
its symbol table This is handy for 
resolving undefined function errors 
during link. Another unique lacility is 
SID, which stands for Symbolic Interac- 
tive Debugger It is an assembly-level 
debugger that supports basic operations 
such as single-stepping, disassembling, 
examining and changing registers or 
memory, and setting breakpoints. It 
doesn't have a mini-assembler built in, 
and it's not symbolic, but it can be ver)' 
useful at times. 

The Alcyon compiler supports two 
of the five ANSI language extensions 
previously mentioned. It allows struc- 
ture assignments and the use of "un- 
signed" as a type modifier It parses 
function prototypes, but makes no use 
of them for type-checking. 

Alcyon C allows a maximum of eight 
register variables. Three registers are 
available for pointer variables and five 
for other register variables, 

EDITOR 

The editor supplied with the Alcyon 
package is called Micro EMACS, If 
you've used the full EMACS on a large 
machine you know that it is an endless 
source of delight. It's fully customizable, 
extensible, and comes with an enor- 
mous amount of on-line help and 
documentation. Of this. Micro EMACS 
retains a minimal, n on- customizable, 
non-extensible subset. It's not a bad 
editor; its major fault is the lack of a 
search and replace funchon, A minor 
fault is the awkward Esc-V key se- 
quence used to page through the text. 
On the positive side. Micro EMACS can^ 
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edit text in several (non-GEM) win- 
dows, but it doesn't support the use of 
the mouse. An informal survey found 
chat most of those who spend the 
majority of their time editing vs. word 
processing, preferred to use the Micro 
EMACS editor 

The minimal worfcing set of com- 
piler, linker, batch utihty, editor, and 
necessary libraries for Alcyon C comes 
to 455K of disk space. By splitting com- 
piler and linker files and juggling disks, 
it is possib]e to work on small programs 
using Alcyon with one single-sided 
drive, but not really practical. Indeed, 
the lengthy compile and link times for 
this package make any floppy-based 
system almost unbearable. The only real 
alternatives are a large RAMdisk, or a 
hard disk. 

SUPPORT 

To really take advantage of Atari's sup- 
port with this package, you will need a 
modem and a CompuServe account. 
Atari maintains a CompuServe SIG 
dedicated to registered developers. Here 
you'll find frequent bulletins with the 
most-asked questions and their an- 
swers, announcements, copious source 
code to study, additional tools and utili- 
ties, and direct access to Atari's techni- 
cal and marketing support. 

CONCLUSION 

There's a lot to love and a lot to hate 
about this package The support is un- 
paralleled. The documentadon has 
more information than is available from 
any other single source. And there are 
more cools and utilities that come with 
this compiler than with any other On 
the other hand, the documentation is 
pooriy or^nized and contains 
significant amounts of irrelevant and er- 
roneous material. Also, the compiler 
and linker are by far the slowest of the 
four reviewed. The principle advantage 
to Alcyon C and the Developer's Toolkit 
is its support 




MEGAMAX C 

Meg^max is hoping to lure software de- 
velopers away from DRl and the Alcyon 
package. With this intent, they are offer- 
ing most of the features that the Alcyon 
development package has, plus some 
nice extras. The heart of the Megamax 
package is a one-pass compiler If you 
are as tired of working in a batch mode 
with your C compiler as we were, then 
you will really enjoy working with a 
one-pass compiler Compiles that took 
ten or fifteen minutes now compile in 
one or two, Megamax claims that it 
compiles ten times as fast as the Alcyon 
compiler With smaller programs, we 
have noticed about a five to one ratio. 
When compiling DOODLE, the differ- 
ence was incredible! 

DOCUMENTATION 

After wading through 4,000 pages ol de- 
veloper's documentation, or looking up 
brief, inadequate GEMDOS function 
descriptions, the Megamax documenta- 
tion is a joy to behold. It is clearly writ- 
ten, and typeset by laser printer Each 
function call is on a page by itself and 
the user is almost never sent thumbing 
through to the manual to find explana- 
tions. Generally, where the information 
could reasonably be reproduced, it was 



inserted where it was needed-even if 
this meant copying sections of the man- 
ual verbadm. They do have a small 
problem with the VDl secdon: All the 
function calls in the index are ofTby 
one page But they are therel They have 
even reprinted all of the "H" files for 
easy reference. 

An important consideration for any 
professional ST developer is the quality 
of the GEM hooks. We could find no 
GEM hooks, BIOS or XBIOS calls that 
Megamax did not support. Just as im- 
portant, they have thoroughly and 
cleady documented them. The package 
includes over 300 pages of documenta- 
tion with only one function per page 
The table of contents is accurate and the 
index is a sight for sore eyes. Without 
question, the documentation is the best 
available to an ST software developer 

USE 

The Me^max shell places you in an en- 
vironment very similar in look and feel 
to the GEM Desktop, Several drop-down 
menus give you the abihty to compile, 
link, execute, change libraries etc. Thus, 
without leaving the shell, you can rake a 
program from source code to execution. 

In conjucuon with the shell, Me^- 
max has created their own dialog boxes 
which offer some nice features unavail- 
able with standard GEM boxes, Meg3- 
max's boxes provide considerably more 
information and you can scroll through 
an entire directory by holding down the 
mouse button on the scroll arrows. To 
avoid cluttering your screen, the dialog 
box only displays the applicable files. 
For example, while in the compiler, only 
the ".C" files are displayed. Unfor- 
tunately, while the shell remembers 
what disk drive you are using, it doesn't 
remember what directory you are in. 
This means that anytime you need to 
compile or edit, you have to walk the 
program down from the root directory. 
The path length chat you are able to 
type in is somewhat limited as well. A 
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hard disk makes these limitations par- 
ticularly annoying. But, overall, the shell 
is quite convenient to work with. 

A feature of the Megamax compiler 
some developers may feel is a disadvan- 
tage is that it does not and cannot 
directly produce assembly source code. 
This speeds up the overall compile 
process tremendously But, if you like to 
develop in C, then manually optimize 
the intermediate assembly source code, 
it can be quite involved. A disassembler 
is included, so compiling your code, 
[hen disassembling it is possible. But 
this whole process is annoying. 



1 egamax produces "pure," 
1 relocatable code, which 
I means it separates the 
data and program code. Because they 
are separate, if you exceed the bounds 
in an array reference, you destroy data, 
but you don't destroy the program itself. 
However this introduces the major 
drawback of the Megamax compiler; no 
single execution program segment can 
be over 32 kilobytes in size This limits 
any given function to less than 32 kilo- 
bytes and requires that the programmer 
add compiler directives in the source 
code, telling it :o break up the code into 
appropriate-sized blocks. The linker 
then resolves addressing problems be- 
tween overlays by means of jump tables. 
Me^max is considering using this as a 
memory-management and overlay 
scheme at some future date However, at 
this nme, the endre program loads into 
memory. Except for adding the compiler 
directives to the source code, this whole 
process is completely transparent to the 
developer and the user 

While this is a holdover from the 
compiler Megamax developed on the 
Macintosh, it has some advantages. The 
first is that, within any given segment, 
the execution times are much better It 
also means that if Atari comes out with 
a multi-tasking operating system, mem- 



or)' management is already built into 
the code, Since Atari is a UNIX licensee, 
this is something to keep in mind. The 
code is generated almost exclusively 
with PC relative addressing which 
reduces code size and increases code 
speed. 

One of the nicest features of this 
compiler is the error log. If you have a 
program which takes forever to compile, 
you can get up and stretch your legs. 
Should an error occur, the compiler will 
save it to a file. When you get back, just 
check for the presence of an error file. 
We do have a quibble with this feature: 
If you have an error file left from a 
previous compile, an error-free compile 
will leave it intact. It would be less con- 
fusing if a clean compile erased the old 
file. 

The linker is an intelligent linker; it 
only loads the external symbols and 
functions it needs, thus reducing code 
size. Because the 68000 has special ad- 
dressing commands that take advantage 
of nearby addresses, the smaller code 
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size can mean taster execution speed. 
When the Unker scans for either a func- 
tion or a symbol, it stops at the first in- 
cidence of the definition. Since the sys- 
tem library is loaded last, the user can 
redefine parts of a library and still ac- 
cess other parts of the same libraiy. 

The Megamax linker is the slowest 
program of the package To use the 



Imker from the shell, you single-click 
the files that you want to hnk, then add 
them to the link-list window. Once you 
have added all the files you want linked, 
click the OK button and Me^max loads 
and links the program. The system li- 
braiy is automadcally searched and is 
not even listed when the program asks 
what you wish to link. Therefore, unless 
you create additional libranes with the 
"librarian," you only need to explicidy 
link one file 

The librarian referred to above is 
an interesdng additional fea- 
ture. One of its principle func- 
tions is to facihtate modular compila- 
uon. Once you have a module 
debugged, you compile it and put it into 
a library module. Then you just link the 
library module with the development 
module at link time Since the librarian 
resolves all local references, this not 
only reduces the amount of code re- 
quiring recompilation, but speeds up 
the linker It also reduces the si2e of the 
librar}' module. 

Me^max can effectively be used on 
one single-sided disk drive: a nice, 
money-saving feature The basic com- 
piler, linker, librarian, system library, 
shell, some sample source code, etc., 
use less than one single-sided disk. 
Thus it takes up minimal storage on a 
hard disk, and the whole program will 
fit nicely onto a RAMdisk, Unhappily, 
pornons of the Megimax files must re- 
main on the top-level root directory, so 
you cannot place the whole system 
within a folder This is inconvenient for 
hard disk owners. With a RAMdisk, the 
edit, compile, link and execute cycle is 
measured in seconds. Even with the 
standard single-sided disk drive and 
512K of RAM in a minimal 520 ST sys- 
tem, the program performs ele^ndy 

Another particularly nice feature is 
that Me^max can handle, compile, and 
link a source file which is in a different ► 
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disk drive than the compiler, Unker and 
header files, without requiring any spe- 
cial contortions on the part of the pro- 
grammer. Just single-click the disk drive 
you want to use and the shell Usts all 
the applicable files on that disk. If you 
want to use them, activate them with a 
single-click, then chck the OK button. If 
you are compiling, the compiler will 
produce a ".O" file on the same disk as 
the source code. If you are linking, by 
default, the program will produce an 
A.PRG file on the same disk as the sys- 
tem. You can redirect it to a different 
disk or file name if you like. Unfor- 
tunately, it will not do multiple com- 
piles or links. Nor will it compile and 
hnk in one command. 

Meg3max has abided by the Kerni- 
ghan & Ritchie standards and added 
several extensions from the new ANSI 
standard. These include structure pass- 
ing structure assignment, and functions 
returning structures. The same member 
name can be included in more than one 
structure, and character constants can 
be both integers and lon^. To allow 
programs larger than 32K, tfiey also ad- 
ded the overlay mechanism mentioned 
previously. 

EDITOR 

The Megamax editor is a mouse-based 
editor that includes complementary 
keystrokes for the drop-down menus. 
Nonstandard use of the arrow keys was 
[he worst problem that we encountered; 
the cursor keys move the window in- 
stead of the cursor Only the mouse 
moves the cursor. Another major failing: 
It can't handle files greater then 32K. 
While this editor may be a little better 
than some of the keyboard-based edi- 
tors available, it is quite poor and 
difficult to use. Along with the 32K 
compiler limitation, the editor is a weak 
point in the Me^max package We do 
not feel that it is adequate for a profes- 
sional environment and, in fact, do not 
use it. We have found the GST editor to 



work very well within the Megamax 
shell. For that matter, LST Word, which 
is free, will also work very well with the 
Megamax system 

EXTRAS 

The Megamax package comes with 
several unusual additions, including: a 
code optimizer, a full resource construc- 
tion set, a disassembler, a "make" utility, 
Megaroids (the arcade game bundled 
with the ST, written in Megamax C), and 
a set of example programs Some of the 



The GST shell 

uses the GEM 

environment better 

than any of the 

other 

packages. 



example programs demonstrate writing 
direcdy to screen memory, how to for- 
mat a floppy disk from within a pro- 
gram, use of in-line assembly, creating 
application skeletons and accessory 
skeletons, and how to create a dialog 
box. Additionally the source code for 
the support libraries is available for $50. 
This includes both disk and printed 
hard copy A hard copy of Megaroids is 
available for $25. 

SUPPORT 

We have called upon Megamax ior tech- 
nical assistance a number of times and 
invariably have found that the Megamax 
technicians not only knew their own 
compiler, but understood GEM! Having 
first written a C compiler for the Macin- 
tosh, they have some unique insights to 



the strengths and weaknesses of both 
systems and are a valuable asset to any 
programmer. Megamax has one full-time 
person dedicated solely to supporting 
their compilers. This may be contrasted 
with companies who rely on their com- 
piler developers to also substitute as 
support, Megamax does not have toll- 
free phone number, but they do publish 
their phone number where it is plainly 
visible and usable. Since the first copy 
of the compiler that we received was a 
pre-release version, we called them a 
number of umes. Without exception, 
they were very helpful. 

Megamax has a reasonable upgrade 
policy. For $20.00 they will send you 
the latest version of the program and 
any necessary documentation. 

CONCLUSION 

At two hundred dollars, Megamax has 
priced their compiler beyond the casual 
programmer. But the serious developer 
will have a hard time finding a better C 
system, Megamax has concentrated on 
those areas where the Alcyon compiler 
is weakest, i,e-, its interface, speed of ex- 
ecution and documentation. They have 
produced a very nice package Admit- 
tedly, some will find the 32K program 
limit a major flaw in this package. But 
we have worked considerably with 
other C compilers on both minis and 
micros, and the only thing we miss 
with the Me^max compiler is a source- 
level debugger and a decent editor It is a 
good, solid package that any program- 
mer can use and enjoy. 
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GST 

We had a good first impression of GST's 
C package. Its interface is smooth and 
the editor ver)' similiar to 1ST Word, the 
word processor that comes bundled 
with the ST, Unfortunately, we soon felt 
very restricted and frustrated. This 
product is a very good prototype of a 
professional package. Unfortunately, at 
the time of this writing, it is too 
unfinished to be a serious contender for 
the professional developer 

Currently, it does not support some 
of the fundamental constructions of C. 
This is particularly limiting since many 
GEM calls require the address of a 
structure as a parameter This doesn't 
mean that productive and professional 
products can't be produced with this 
package. In fact, according to their 
documentation, the compiler itself and 
all the other products from GST, includ- 
ing 1ST Word, were written either with 
this compiler or their macro assembler 
However, in addition to problems with 
the language implementation, the GEM 
documentation accompanying GST C is 
not sufficient to produce a product 
ready for market. They refer you to the 
GEM manuals from the Developer's 
Toolkit. As previously mentioned, GST 



shouldn't be expected to reproduce the 
information on GEM. but compared to 
the other packages, the amount of GEM 
documcntLition is extremely limited. 

DOCUMENTATION 

The GST documentation leaves quite a 
bit to be desired. Their explanation of 
the various menu items in the shell is 
fairiy thorough, but they fail to explain 
all of them clearly It has no index, but 
the table of contents is quite good and it 
has a function summary showing the 
parameters that each function needs. 
Unlike most of the other systems, GST 
gives a brief explanation of each of the 
language constructions they have im- 
plemented Co date This serves to docu- 
ment the features of their implementa- 
tion and it introduces the beginning 
programmer to the C language. 

The accompanying system libraries 
are a reflection of the entire GST lan- 
guage implementation: an interesting 
combination of possibilities and missed 
opportunities. GST C has a nice stan- 
dard C library and it is well sup- 
plemented. However, only a few UNIX- 
standard calls have been implemented. 
It is missing several low-level UNIX calls 
such as "open" and "close". In spite of 
not having these calls available, the file 
I/O is surprisingly quick. Since casts, 
stmctures. floating point and noninteger 
functions are not available with GST, 
there was no way to compile DOODLE, 
and we had to rewrite the benchmarks. 
The timer routines available with GST 
were only accurate and precise to 
within two seconds, which made 
several ol the benchmark times 
meaningless. 

Offsetring a rather strange standard 
library is a delightful supplemental 
GEM library that removes much of the 
tedium from the GEM interface by do- 
ing some of the housekeeping for you. 
As part of this approach, your program 
is automatically placed in a window. It 
is pretty startling the firsi time you write 



a "hello world" program and see it 
come up in a window with borders, 
scroll bars and the rest of the window 
niceties. GSTs version of windowing 
calls are quite a bit easier to work with 
than the normal GEM calls. If portability 
is not a concern, this is a very nice fea- 
ture Depending on your application, 
you may not need or want the low-level 
routines that were not implemented. 
This library could justify using GST if 
your primary concern is developing a 
quick prototype and you do not want to 
spend a lot of time fighting with GEM, 

USE 

One of the reasons GST's limitations are 
so frustrating is that the user interface 
and editor in this package are among 
the best available for the ST In many 
ways the GST shell uses the GEM envi- 
ronment better than any of the other 
packages. It is well designed and intui- 
tive. You can compile, assemble and 
link a program from a single drop-down 
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menu, if you have already compiled, 
you can just assemble and link. You 
may also link an assembled ttle. The 
program keeps a log of your activities so 
that if you are not paying attention dur- 
ing a compile or program execution, it 
tells you the results. It is a very well- 
done interface, 

GST uses a one-pass compiler that 
works reasonably quickly. The syntax 
for handling in-line assembly is a little 
diflerent than the other compilers, but it^ 
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C FOR ME... 



is not excessively cumbersome 

The compiler has an option to pause 
on locating an error condition. However, 
for some reason, when we used this, it 
seemed to hang for a while, then go on 
randomly after several presses of the Re- 
turn key. One useful command option 
is the ability to have your comments 
from your C source code preserved and 
passed on to the assembler code. 

The GST assembler is a very quick 
two-pass assembler. You have the op- 
tion of producing either relocatable or 
nonrelocatable code It is intelligent 
enough to spot long branching instruc- 
tions that could be replaced with short 
branches and it warns you about them. 

The GST linker is the same one used 
by Lattice C. It can be instructed to ei- 
ther include an entire library, or import 
only those roudnes required for hnkage 
In tight programming environments, 
this lets you opdmize code size The 
linker requires a command file to pro- 
duce its output. The command file tells 
the hnker what files to hnk and which 
libraries to search or include According 
to drop-down menu options, the output 
and error messages of the compiler, as- 
sembler and linker can be re-routed to a 
file, a Hst, the console, or an auxilary de- 
vice Unfortunately, this feature and the 
command file for the linker are not well 
documented and we couldn't get the 
redirection to work properly, 

A real problem we ran into was the 
size of the intermediate code With two 
double-sided disks-one for the system 
and one for the source code-we often 
had to stop and delete files from the 
disk. On any given compile, five files 
are produced and retained. This situa- 
tion makes a single-sided, single- 
density disk system useless for any 
significant development. 

EDITOR 

The GST editor is the highlight of the 
package It is GEM based and very simi- 
lar to 1ST Word. If you are switching 



back and forth between word process- 
ing and program edidng, this saves the 
necessity of readapting to a different in- 
terface each time The function keys 
have been redefined to suit actions 
appropriate to a programming 
environment-such as "move to the end 
of the hne," etc. Like 1ST Word, the 
function-key boxes are drawn at the 
bottom of the screen and the program- 
mer has the choice of keyboard input or 
mouse input, The editor is slow to re- 
spond, so it is easy to "get ahead of it" 
while using the cursor keys. 

The ability to go to a specific hne 
number is an important feature this edi- 
tor lacks. GST avoids the necessity of 
line numbers by lisring each function as 
it is compiled. It then lists the offending 
line Usually this is enough to get you in 
the appropriate area of code if you are 
using the GST compiler with the -m 
option. Another missing feature is con- 
tinously scrolling scroll arrows. GST has 
implemented the continuous scroll ar- 
rows in the dialog boxes, but for some 
reason they didn't use them in the edi- 
tor itself. 

In spite of these problems, this is the 
editor we use with large-scale code It is 
easy to use and handles extra-large files 
easily and without problems, With just 
a little bit of clean up it would be worth 
the purchase price of the package alone. 

SUPPORT 

Antic Publishing, Inc. is supporting this 
product. They offer bug fixes free and 
upgrades at a nominal charge As of 
June 1986, GST is planning a toll-free 
800 number for technical assistance, 

CONCLUSION 

Those features of GST which have been 
implemented, have been implemented 
very well. The shell and editor use the 
GEM environment better than any 
package currently available. The fun- 
damental difficulty of the GST C pack- 
age IS the features which were not im- 



plemented. As it stands, GST C is 
reminiscent of Small C from Dr Dobbs. 
Because of its low price, we would like 
to be able to recommend it to beginning 
programmers. But without structures 
and other essentials of the C language, 
we are unable to do so. The tricks, and 
techniques that this package would 
force one to use might create bad pro- 
gramming habits. However, GST C has 
the potential to be a real winner if the 
company chooses to finish it. They are 
trying to do that as fast as they can. We 
look forward to seeing the finished 
product. 

SUMMARY 

Each of the development packages men- 
rioned has certain advantages. If you are 
a software development house, or have a 
program ready to market, strongly con- 
sider the Developer's Toolkit with its 
CompuServe connection and marketing 
support. For a development compiler, 
Megamax C is, without quesdon, the 
best available on the Atari, It will reduce 
your compile/test turn-around time by 
at least a factor of five By taking advan- 
tage of the make utility and code modu- 
lation, this factor can increase to as 
much as ten. Unfortunately, at $200, it 
is a bit expensive for many people 
With many students, and hobbyists, 
price is the single most important factor 
The Lattice compiler, at $50 less, does 
not really offer a significant savings. 
However, its compadbility with its IBM 
cousin is a real plus. On the IBM PC, 
the same compiler, without an editor, 
has a list price of over S400. On the 
lower end, the GST package comes in 
with a very nice shell at half the price of 
the Latrice package. Depending upon 
how quickly GST upgrades it, this pack- 
age is one to keep an eye on, ■ 
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REFERENCE: 

• COMPUTER LANGUAGE Magazine, 
131 Townsend Street, San Francisco, 
CA 94107, (415)957-93,53 



LIST OF 
MANUFACTURERS 

Alcyon C (Developer's Toolkit) 

Atari Corp,, 1196 Borregas Avenue, 

Sunnyvale. CA 94086, (408) 

745-2000 

$300 

CIRCLE 204 ON READER SERVICE CARD 

Megamax C 

Megamax, Box 851521, Richardson, 

TX 75085, (214) 987-4931 

$199.95 

CIRCLE 205 ON READER SERVICE CARD 

Metacomeo's Lattice C 

The Catalog, 524 Second Street, San 

Francisco, CA 94107, (800) 443- 

0100 Ext. 133 

$149.95 

CIRCLE 206 ON READER SERVICE CARD 

GSTC 

The Catalog, 524 Second Street, San 

Francisco, CA 94107, (800) 443- 

0100 Ext. 133 

$79.95 

CIRCLE 207 ON READER SERVICE CARD 



ATARI ST C COMPILERS 

ALCYON MEGAMAX LATTICE 



GST 



Price 


$300 


$200 


$150 


$80 


Full K&R 


yes 


yes 


yes 


no 


Number of registers 


8 


6 


8 





Integer size 


16 


16 


32 


32 


* Minimum disk size 


711 K 


325K 


53BK 


398 K 


**Minimum drives 


2 


1 


2 


2 


GEM doc. 


yes 


yes 


partial 


list 


index 


partial 


yes 


yes 


no 


ANSI extensions 


portio 


partial 


full 


no 


GEM shell 


no 


yes + yes 


yes 


* Disk usage includes editors and oil library and link files. 
+ + Minimum single-sided drives for 'practical' usage. 
+ As of June 1986, Lattice Is shipped with a GEM shell. 


BENCHMARKS 
DOODLE: 


ALCYON 


MEGAMAX 


LATTICE 


GST 


Floppy compile 


17:50 


1:28 


8:36 


N/A 


Floppy link 


5:45 


1:41 


6:55 


N/A 


Hard disk compile 


6:37 


:40 


5:15 


N/A 


Hard disk link 


2:16 


:48 


2:10 


N/A 


End code size 


16,705 


15,854 


36,154 


N/A 


DHAMPSTONE: 


ALCYON 


MEGAMAX 


LATTICE 


GST 


Floppy compile 


5:08 


0:30 


2:29 


1:27 


Floppy link 


3:21 


1:44 


4:34 


2:44 


Hard disk compile 


1:56 


:12 


:48 


:45 


Hard disk link 


1:38 


:26 


1:22 


:38 


End code size 


18,154 


11,075 


19,000 


25,652 


DHAMPSTONE 

TIMES: (in seconds) 


ALCYON 


MEGAMAX 


LATTICE 


GST 


Strings 


7.87 


7.60 


7.57 


10 


Integers 


2.03 


2.05 


3.11 


4 


Longs 


.27 


.25 


.38 


2 


Unsinged 


1.65 


1.85 


2.00 


2 


Double 


.120 


.72 


.10 


N/A 


* Disk I/O 


35.70 


9.67 


20.07 


16 


* Dhampstone creates 
string buffer and wri 


a test file of 12,987 bytes by assigning a short 
ing it to disk 1,000 times, one byte at a time. 
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START SAVING NOW! 

Atari 520ST 637.00 



520ST W/SC1ZZ4 RGB color ft 





^fiwr.huwam 










189 50 




209.00 














^^H-TTT 


Rim^v 




130X£ computer 


125.00 










XM301 modem 


35,00 


Digital devices interfaces... 


CALL 




.^Hlslii 


TKITT^^V 





Degas 25.00 Music Studio.... 

Easy Draw .94,00 Pawn 

F15 Strike Eagle 29.00 PC Intercom ... 



....95,00 Silent Sen/ice.... 



....29.00 
....78.00 
-..25.00 



...34,00 Sundog.... 



Mud Pies 25.00 Time Bandits.... 



tBMVBtttmttW 



SOFTWARE 



P.O. BOX 6566 SOUTH BEND, IN 46660 
Call or wrlle lo be put on mailing list. Order lines open 10 AM-6 PM EDT Mon-Fri. Price 
reflect cash dlscounl. MC/ViM add 4%. Shipping/handling: add 3%. $7 minimum. Interna 
Mgnal orders may require additional SS-H charges. IN orders Indude 5% sides tax.-MI price 
sub]ecl to change. All Items subjecl lo availabilHy, 



circled;] on reader service card 



Megamax C 

for the 

Atari ST 

Featuring 

• One pa.ss Compile ■ In-Line Assembly • Smart Linker 

• Full Access to GEM routines • Register Variable 
Support ■ Position Independent Code • and much more. . 

System Includes: 

• Full K&R C Compiler (with common extensions) 

• Linker • Librarian • Disassembler • C Specific Editor 
Code Improver ■ Documentation • Graphical Shell 



Benchmark Compile Execute 

Time Time ■" 

Sieve 



Time 

70 2.28 5095 

Hello, world" 63 N/A 4691 

*Times in seconds. Sieve with register variables. 



Jp 1 " " , y 5 For more information, call c^ write: 

Megamax, Inc 

Box 851521 

Richardson, TX 75085 ^g^ k 

(214) 987-4931 

VISA, MC, COD ACCEPTED 

CIRCLE 062 ON READER SERVICE CARD 




PUBLIC NOTICE 



GEMINI WILL MATCH 

ANY ADVERTISED PRICE & 
GIVE FREE SHIPPING 



ORDERS SHIPPED WITHIN 24 HOURS 
FULL EXCHANGE ON DEFECTIVES 



Gemini Enterprises, one of Atari's 

largest dealers, will match any 

advertised price and ship FREE in 

continental U.S. Send certified check or 

money order, stating publication & page 

number of item you want price matching 

on, to — 

GEMINI ENTERPRISES 

692 Milford Road 
East Stroudsburg, PA 18301 

(717)424-2248 

»5'>o HANDLING CHARGE FOR APO & FPO ADDRESS. 



CIRCLE 030 ON READER SERVICE CARD 



ATARI ST USERS!" 

ENTERTAINMENT JACKPOT 

20 BIG PROGRAMS WRITTEN IN ST BASIC 

72 PAGE MANUAL INCLUDED 

ALL FOR ONLY 534.95 

SITOR THE WRITER 



BOMB SQUAD 



ADVENTURE CREATOR 



(analyzed indelail. Apoweitu 
le language parser touTme i! 
>nd eiplained BASIC graphics 



THERAPIST 



3-D TIC TAG TOE 



(Diikand Manual! 

Only 334.95(843. 95 CanBdiBn);M.O., 

VISA. MASTERCARD (include Bxpiry), 



OTHELLO 

Beat [he computer. 

CHECKERS 
CRIBBAGE 
BACKGAMMON 



ANALYSIS 

Convincing -per 
(Offun.MimicS! 



CHARGE CARD ORDERS ONLY 



(204)269-3234 



CIRCLE 061 ON READER SERVICE CARD 




CLIPBOARD 



From the GEM Desktop, you can access an "inactive" window by first holding 
down the right mouse button, then, while holding it down, clicking che left 
mouse button on any item within the inactive window 

' A standard configuration 520 ST can safely handle a 200K RAMdisk. 

II you need to reboot your ST, be wary of the Reset button. The Reset button only 
performs a "warmstart" which may leave unwanted data in che registers. To play it 
safe, it's best to use the power switch. Also, when rebooting a 1040 ST, turn the 
power off and count to 15 before turning it back on. It takes a while for che 1040 ST's 
power supplies to "zero out," This is particularly important when using a 
[MM disk. 

To make a program autoboot: From the File drop-down menu, create a folder 
called AUTO, The program you wish to start automatically should then be 
dragged into che AUTO folder The chosen program must have a .PRG extender 
You can also use a .TOS program that does not make AES or VDl calls (since the 
AUTO folder is executed before GEM is initialized). Be sure to rename the file so 
that it has a ,PRG filename extender Now, power up your ST with the AUTO 
folder disk in drive A and your program will be executed. (See "The Amazing 
MouseTrap" in this issue for an example.) 

histead of opening and closing windows to view files when changing disks, press 
[Escl. This will cause the active drive to reread the disk. 

The ST only allows a maximum of six desk accessories. If you want to put more 
than that on your boot disk, but only want a select few to automatically boot into 
the Desk menu, change the extenders of chose you don't want from ,ACC to ,ACX, 
The operating system will ignore the .ACX files. 

Though your program may be automatically relocated by GEM, there is a quick 
and dirty way for an assembly language program to find out where it is in mem- 
ory It makes use of the fact that a jsr pushes the PC (Program Counter) register 
onto the stack before jumping to the subroutine. The following code will load the 
absolute address of LABEL into address register (AO): 



jsr LABEL 

LABEL: movea.l (SP)+,AO 



;push the addr onto the stack 
;now, pull it off 



m->K-:-:-:-3 



■ When printing a text file to the screen from the Desktop and the MORE 

prompt appears at the bottom, you probably know that pressing any key will 
pnnt another screen of text. Did you know that pressing [Return] will print only 
one hne at a time? Tr)' it. 

■ II you use the Developer's Kit, you can install the BATCH.TTP program as TOS- 
Takes-Parameters with a Document type of BAT, then anytime you open a .BAT 
(BATch) file, it will automatically run under the BATCH.TTP program. 

(Editor's note: Got an ST tiick or tip to share? Send it to START. Attention CUPBOARD.) 
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MICRtJTYMI 



A 

ATARI 



Vk 



ATARI 



A DIVISION OF MICRO PERIPHERALS, INC. 

P.O. BOX 3BS 

KETTERINS, OHIO "53409 

ATARI 

SOFTWARE and BOOKS 

r.ALL ST SOFTWARE . TOO MUCH TO LIST CALL 

CALL ALL iiites tram, HaQa, VIP, BroderCund. 

CALL Mark of Ihe Unicorn, Hippd, Unison Wdria, 

CALL MIgraph, Oss. Inlocom, Alari, Michtron. 

. 125 SST Systems, Mirage Concepts, etc. 

. 89 We nil! have sverylhing WGRTH having! 

125 "THE C PROGRAMMING LANGUAGE" Dy B.W, 

. .25 KernighanandO.M.RIIcnie . . i! 

. 15 a BIT SOFTWARE . . . FOR THE LATEST, CALL I 

.26 PAPERCLIP 

319 PRINTSHOP 

. 15 GRAPHICS LlBRAfiY #1 , *2, or #3 (each) 
O.S.S BASIC XE. 

D S.S.BASIC XL 

.219 

249 MONITORS 

. .339 TEKNIKAMJ-lOCompoSiteColor 

549 TEKNIKA MJ-22 RGB anfl Composite 

.279 THOMPSON Green W/Audio . .. 

.429 THOMPSON Amber W/AuOio. . .. 

9 THOMPSON Composite Color . . 



52DST's . Cmon Now. Dolt! 
SF3U Double SiOeflDnue 
SHD 204 20 Megabyte Hard Disk 
SC1224RGBColorMonilOi. . . 

130XE . (a-bilWonderoftheWorld') 

65 XE 

lOSOOiskDme 

1020CDlotPrinter/Plotle( 

Power Supply 400/300/810 1050/850 
Power Supply 600/800 XL, 130 XE 

INDUS GT 

Power Supply tor Indus GT 



PANASONIC 

kX-PIDBO . 5NL0M0DESINEW 
KX-P1091 . .. .Rated the No. 1 Primer 
KX-P109280col,True180cps . . 

KX-P1592136col,True1B0cpS 

KX-P313U,0 Daisy, 80 col . . 
KX-P315IL.0. Daisy, 136 col . .. 
KX-P110Ribbon,Blk 
COLOR RIBBONS 



CITIZEN 



50 (80 col) 

ib (80 col) . 

I FX-2B6200cpS(135col) . 

STAR MICRONICS 

I NX-1[l(80col|. . NEWMODEL. 

10 (80 col). 

j SG-151135C0I). ... 

STAR SG- 10 Ribbons. 



MODEMS 

ATARI 1030 45 

XM-JDl Direct Conned , , 36 

QMI1200STlfor52QSTComplete!) ... .179 

HAYES 1200 Smartmodem 399 

US ROBOTICS COURIER 2400-100% Hayes! 429 
PRENTISP2I2ST-I200bps, 100% Hayesi 239 
SUPRA1200AT 179 

SUPRASTMODEM. 1200bps 179 

VOLKSMODEM 1200. 189 

AVATEX Smart 1200 bps . Special 99 

INTERFACES/BUFFERS 
ATARI 850 . . In Slock! . . . . 118 

P.R. CONNECTION (100% B50 compatible) 
CABLES- We've Gol 'Em . 
U CALL (For Hayes, etc. ) . 

U PRINT A 

UPRiNTA-64wilh64KBuller" 
APE FACE XLP. ... 
SUPRA/MPPMICROPRINT . . 
SUPRA/ MPP MICROSTUFFER (54k Sutler) 
SUPRA/MPP1150 . 



ACCESSORIES 

239 ST- COVERS. Heavy Grade Vinyi 
CALL ST" MOUSE MAT, Malcbifig ST Color . 
ST- 6' Primer Cable 
ST- Modem Cable [lo Hayes, eic.) 
239 ST- MonitorSiana.Swivel&Tili 
379 OiskFile1or3.5"disks(halds40) 
539 Flip N File OATA CASE (Holds 50) . . . 
Disk File, with Lock (holds 1O0!) . .. 
Rotary Disk File (holds 72) ... 
CALL pQ„gr strip, 6 outlet, (15 amp Surge) 
223 Pfinler Stand, Heavy Duly. Sloping . 
''^^ ATARI "Slanflard" Joystick ... 
^ 5' AiaiESeriali/OCaOle .. 
CompuServe Starter Kit 
.S □0UBLER(Dbl.Oensitytorl050) 



. CALL 



"Duplica 



Biu.Pnk.Gn, Vel, 800 pack (200 ea) 

per 500, any 1 color 

per 1000, any 1 color 

Big Labels, 1-7/16x4", White, per 500 
PRINTER PAPER, Micro-Fine perls, 20 lb 
500 Sheets, Pure White Bond 

Canon(2600sheets),asabove . ..; 

PRINTSHOP "Rainbow" Oolor Paper Packs 

Pasiels(5colors),505heetso(ea 1 

Matching Envelopes, 20 ol each 

Brighls (8 colors), 50 sheets ol ea : 

Matching Envelopes. 20 ol each 1 

ALLi3coiors,5Dsheetsoleacb . . ; 

Matching Envelopes. 20 ol each . .. ) 
(Ooiliicl 10% lor lOO/color paper packs) 



Prices Are Per Box of 10 DISKETTES Minimum Order ot 2 Boxes S 


Boxes 


GENERIC 


BONUS 


VMBASH 


3.5" MICRO-FLOPPIES I 


SONV 


VEitdAI'M C 


SS/DD 


OS/DD 


SS/DD 


DS/DD 


SS/DD 


SS/DD 


DS/DD 


SS/DD Jl 


25 


6 50 


10 50 


10.50 


13.50 


10 50 


20 50 


29 50 


15 50 X 


y 6-10 


7 50 


9 50 


9 50 


12.50 


9 50 


19 50 


2S50 


1JM 6 


J Rainbow CGloredCentech Disks (2 eaot 10 colors per pkg) 17 5 
5 "Silver" Centecli Disks (20 Pack) 17 Jj 


; TO ORDER, CALL TOLL FREE 

1-800-255-5835 



MTH9am-9pm • FRI9am-5pm • SAT 10 am-2 pm i 

EST 

Ohio Residents, Order Status or 

Tech. Info Call (513) 294-6236 
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520 ST 

1 Megabyte 

RAM UPGRADE BOARD 

• Fits under RF Shield 

• Minimum Solder Connections 

• Do it Yourself Installation 

$174.95 

Dealer Inquiries Welcome 

Send Check or Money Order to: 
DIVERSE DATA PRODUCTS, INC. 

1805 NE 164 Street 

North Miami Beach, Fh)rida 33162 

(305) 940-0458 

(305) 940-4763 

Oj(I t;f Coiinlry Ortlers add $10 Shipping 

Use III!. Moiu'y Orders payable in U.S. Fnnd 

Florida Residents add 5% M.v 
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Technical support, personal service, com- 
petilive prices. 
Disclone full service quality tested diskette 
duplication, packaging, documentation pro- 
duction and processing ensures precise 
duplication, thorough quality control and 
expedient response to your requirements, 
NOclone state of the art hardware based 
copy protection is true piracy protection for 
authorized allotments only. Each application 
is uniquely encrypted. Install routines are 
coded for nontransferrable hard disk allot- 
ments. 

Disclone offers a choice of diskettes. Com- 
mittment dates are guaranteed. Fast turnover 

■ up to 1000 in 24 hours, any format. 

■ up to 10,000 in one week, any format. 



^<^€ 



DtSCLONE. SOfTV^^RE PRQDUCT\ON SERM\CES 
1050 North Fifth Street, San Jose, California 95112 



PROCEDURES 



Structured I/O 



Complicated C Technique Simplified 
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All indispensihle C routine for the quick and elegant 
manipulation of disk flits uus GFMDOS and inlunntC 
stmctwes to sa\L data as a contiguous block oj mtmon 
fiaingthcpiogjajn fwm lahoi tons file mamtenamt Look 
m tht SFRl'C nOSFQ jokht on vow SIARI disk foi 
sampk pfogiams 



MM m pi .rim mil ■vrtsi i i c )1 li I I u i fil u i i il jiii, ]<_ i \ \ n 

m^M hi L pi iTiJin \v hii^h niu=;[ i l m [luK di n t in 1 iir tl ml \ls h ]d 
mWm md In iiki [nfoiiinrnn in^l n,(nr>iiTiu I In nt 1 l l iHl i impli. 
\\ "1) to orgini L hti liU"^ u 111^ itHLtni '^ in tht ( m^ l 

THE PROBLEM 

Di_&ignmg icUiblL routiius [i.r di 1 1 O in lit i lui iiiEin-,i.\p ii n e t r thL 
profe bionil progummcr t^ wlII i th^ no\ ilc Th C libr"tr\ tunc linns bscanf() ind 
spnntfO can ht used lo read oi wiitt simplL tibks ol diu ubing i sLiinj, Lontitninj, 
conversion bpecifications Howlvci it )ou change the mimbcr or t)pt, of. viiiables m 
the data file, the code may be diilicult ro mamtiin 1 he C hngu^gc offers an elegant 
iltcrnatue foi even the most compUcited dita In C structures pro\idc i compact 
mechanism for or^nizmg data on disk as \\ell as m mcmor) i^ 
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PROCliDURES 



Structured I/O. . . 

Input and output are not part of the C language. However, 
some library functions akin to PRINT USING in BASIC are 
available for 1/0, but using them to code routines that are 
reliable and easy to maintain is difficult, Kernighan and 
Ritchie (see Reference below) provide the following example. 
The call, 

int i; 

float x; 

char name|501; 

sscanf("%2d %f %*d %2s", &!, &x, name); 

with input, 

56789 0123 45a72 

will assign 56 to i, 789.0 to x, skip over 0123, and place the 
string "45" in name. This is obviously an appalling situation. 
The programmer must keep track of the number of variables, 
the order of the variables, and the format of each variable-a 
formidable task for all but the simplest programs, 

THE SOLUTION 

Conceptually the data for one disk file can be collected in one 
contiguous block of memory. This block must then be written 



struct person j 

charnamclNAMESIZEl; 

charaddresslADRSIZni; 

long zipcode; 

long ss__number; 

double salary; 

struct date birthdate; 

struct date hircdatc: 
I employee ; 
struct date | 
int day; 
int month; 
int year; 
int yearday; 
char mon_namel4l; 



FIGURE 1: A complicated C structure. 



to or read from the disk. Graphics programs such as DEGAS 
and NEO handle the I/O for their pictures precisely this way 
On the Atari ST, the screen uses 32,000 bytes which are lo- 
cated in a contiguous block of memory. One call to the 
GEMDOS functions Fread( ) or Fwrite( ) with the length and 



location of this block of memory is all that is needed to load 
or save a picture 

We can apply this idea to more complicated data as well. 
In C a structure is a collection of one or more variables, pos- 
sibly of different types, grouped together under a single name 
for convenient handhng. Not only are the variables grouped 
together conceptually in the structure, ihey are also physically 
grouped in contiguous bytes of memory. The C structure can 
thus serve for the image of our disk data file in memory. 

Kernighan and Ritchie, in chapter six of their book, cite an 
employee payroll as an example of a complex data structure 
This structure of type person (see Figure 1) contains within it 
two additional data structures of type date, as well as simple 
variables of various types. We know that the data are grouped 
together, all we have to do is find the location and the length 
of the structure in bytes in order to use the GEMDOS disk 
I/O functions. 

We find the location by applying the address operator »Sar 
to the stucture: 
long location; 



location = &employee; 

C provides an operator to determine the length of the 
structure. The expression sizeof( object) returns an integer 
equal to the size of the specified object. The size is given in 
bytes as if the object was type char. The object may be a vari- 
able, an array or a C structure. We must declare length to be 
type long because a long is required by the GEMDOS func- 
tions FreadO and Fwrite(): 
long length ; 



length = sizeof(employee); 

THE CODE 

The program on your START disk, STRUCTICTOS, is a test 
module which reads and writes a structure of type person. It 
is an example which illustrates several important program- 
ming techniques. In mainC), the structure is first inidalized 
with zeros, and this is then verified by printing the elements 
to the screen. The variables in the structure are then set to 
sample values, and the result is again printed to the screen for 
verification. Following this, a file named EMPLOYEE.DAT is 
created and written to the disk using the structure values. The 
structure is a^in reset to zero, printed to the screen and, 
finally it is refilled by reading the EMPLOYEE.DAT file then 
sent to the screen to verify a correct read. 
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The EMPLOYEE.DAT file is defined in the function file_ 
emp(). Note that this function is complecely symmetric: the 
data going in is the same as the data going out. The only argu- 
ment is the mode, which is set to RMODE_RD for read or to 
RMODE_WR for write 

Notice also that the subroutine does not depend on the 
number of variables, the order of the variables, or the format 
of the variables within the structure. You can change the 
specification of the structure without making any change to 
the input/output routines! 

The actual input/output is handled by the do_io( ) rou- 
tine. This is also a completely symmetric and general routme 
that can handle all of the structured I/O for your program. 

When I design a program. 1 assign each data file to a 
subroutine that looks like file_emp(). Several structures can 
be stored in one disk file like this: 
length=sizeof(a); 
location=&a; 
result=do_io(handle, length, location, mode); 



length^sizeof(z); 

!ocation=&z; 

result=do_io(handle, lengdi, location, mode); 

Only the name of the structure is changed in each three-line 

block of code. This routine reduces the chances of a coding 

error in the specification of the file structure because the 

structure definition determines the specification rather than 

the 1/0 routines. 

Caution: The STRUCTIO program contains no error test- 
ing. Errors can occur at any GEMDOS function call. For ex- 
ample FopenO will return an error if there is no disk in the 
drive and Ewrite( ) will fail if the disk is full. To avoid errors, 
place a formatted, non w rite-protected disk in drive A before 
running STRUCTIO.TOS, 

The variable result, returned by do_io(), contains the 
number of bytes written or read. It can be compared with 
length to test For an error Such errors could be tested in the 
do_io( ) routine if a general error message is appropriate or 
m the file_emp() routine if a message specific to that file is 
appropriate. 

The techniques that I've oudined here can be the basis for 
all high-quality input/output. If you fill in this skeleton with 
thorough error testing, you will find yourself spending a loi 
less time designing and debugging your I/O routines. ■ 

REFERENCE: 

• The C Programming Language by Brian W. Kernighan and 
Dennis M. Ritchie. Prentice-Hall, Englewood Cliffs, NJ 
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Machi: multi-tasking Forth-83/GEM development system 

With everything you need to develop stand-alone applications, 
including: integrated GEM editor, full GEIVl and DOS support, 
Motorola assembler, examples, and our 300 page manual. 

Machl is interactive, so it allows you to experiment with The 
ST without going thru the compile-link-execute cycle. But 
when you do load in programs, look how we stack up: 



Sieve 


Compile 


Linli 


Execute 


Mechl 
Megamex C 
Hippo C 


00.7 

70 

58.4 


00.0 
24 
1:37 


4.41 
3.83 
8.4 


C's w/o registar variables 







(That's three times the execution speed of other Forth'sl 
Note the turnaround time. It simply tal<es less time to 
develop your programs or finished products with Machl , 



Palo Alto Shipping 

PO Box 7430 

Menio Park. CA 94026 

aOO/44-FORTH (Sales) 

415/854-2749 (Dev, Support) 

Available July 15, 1986 



$59.95 

plus $5 S/H 

CA Res. add 6,5% 

VfSA/MC COD 
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timekeep: 

for Atari ST r 



timekeeper™ is o plug-In batfery-bacl^ed 
Real Time Clock Calendar for the ATARI ST 
Computers, The Timel<eeper module plugs 
info fhe caffridge port on the ATARI 
520/1040 ST Compufer, A program is sup- 
plied wifh Timel<eeper thof operates as an accessory like the con- 
trol panel. A feed Ihrough corfridge siol ollows Timekeeper to 
remain installed while using other cartridges. 
The Timekeeper program outomoticolly gets fhe fime and dote 
frorrifhe Timekeeper modules during the power up or boot 
sequence The computer's own clocit is set up and the Timekeeper 
is then disengaged until the computer is turned on ogoin. 

AVAILABLE AT YOUR LOCAL ATARI DEALER, 

or you may use your 
MasterCard or VISA to 
order direct by calling our 
TOLL FREE NUMBER 
below or send checl^ or 
M.O. Pleose add S200 
shipping or S'O shipping if 
outside US. California re^i 
dents add 6% sales tas 



DEALER INQUIRIES WELCOME 
800-654-2821 in California 
800-624-6545 Nationwide 
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NAVARONE INDUSTRIES, INC. 

21109 LONGEWAY ROAD, SUITE C 
SONORA CA 95370 • (209)533-8349 
TLXiWWI 650-230-9046 







SEyco Compute/t cJUa/tfoett(/ig & Cowsu^iants 



1080.... $195 



SAVE 



PRINTERS 



EPSON 

LX80 CALL 

FX65 CALL 

DX10 CALL 

H180 CALL 

HS80 CALL 

FX286 CALL 

LQ800 CALL 

LQ1000 CALL 

SILVER 
REED 

EXP 420 P CALL 

EXP BOO P 489 

EXP 800 P 649 

EXP 770 749 



SEIKOSHA 

SP-1000 A 

Centronics 175 

BP-5200 I 649 

BP-1300 469 

Color Kil 119 

SP-1000 Ribbon. ..8.50 



CITIZEN 

12D-D 179 

MSP-10 285 

MSP-15 335 

MSP-20 325 

MSP-25 4S5 

Premier 35 469 



OKI DATA 

Okimate 10 XE .... 179 

292 GALL 

293 CALL 

Okimale 20 ST .... 199 

120 NLO 205 

182 214 

1 92 348 

93 CALL 



JUKI 

Juki 61 00 CALL 

5510 Juki GALL 

Juki 6300 CALL 

RS232 Seriai 
Bond 55 



NX-10....Call 



STAR 
MICRONICS 

LV12-10(New|...CALL 

NL-10 CALL 

NX-10 CALL 

NB-15 CALL 

SB-15 CALL 

SG-15 367 

SD-10 319 

SD-15 438 

SR-10 469 

SR-15 578 

SB-10 589 

Powertype 297 



MONITORS 
ZENITH 

ZVM 1220 89 

ZVM 1230 89 

TEKNIKA 

MJ-10 149 

PANASONIC 

TR-120 MDPA ...GALL 

HITACHI 

MM-1218 

12" Green 99 

GM-1406 13" 

Color W/Cabie... 179 

MODEMS 

Supra 300 39.95 

Supra 1200 .... 149,95 
XM 301 39.95 



IINTERFACING 

Microprint 39.95 

XETEC AT 39,95 

ATARI 850 109 

APE FACE 39 

U-PRINTA 45 

DRIVES 

INDUS GT Atari.... 179 
ATARi 1050 129 



FIREBIRD 

{520 ST) 



ACTIVISION 

{520 ST) 

Music Studio ....34.75 

Hacker 26.75 

Littie People 29.75 

Paintworks 40.75 

Hacker [1 29.75 

EPYX 

(520 ST) 

Apshai Trilogy . ., 24.75 
Winter Games . .. 24.75 

SSI 

(520 ST) 

Phantasie 24,75 

24,75 



UNISON 
WORLD 

(520 ST) 

Printmaster 24,75 

ArtGaileryiorli,.. 18.75 

TIMEWORKS 

(520 ST) 

Word Writer CALL 

Swift Calc CALL 

Data Manager. ...CALL 

ACCESS 

(520 ST) 

Leader Board. ... 24.75 



SUBLOGIC 

(520 ST) 
Flight Simll... CALL 
Set CALL 



5V4" 

DISKETTES 

MAXELL 

SSDD 9.99 

DSDD 12.99 

VERBATIM 

SSDD 9,50 

DSDD 12.99 

BONUS 

SSDD 6.99 

DSDD 7,50 

SKC 

SSDD 8.50 

DSDD 9.50 

3.5" 
DISKETTES 

3M 

SSDD 16.99 

DSDD 23.99 

MAXELL 

SSDD 16,99 

DSDD 23-99 

VERBATIM 

SSDD 16.99 

DSDD 24.99 

SKC 

SSDD 14,99 

DSDD 19,99 




SYSTEM PRICrNG 
AVAILABLE! 

ATARI 

1050 129 

SF314 219 

SF354 175 

130 XE CALL 

65 XE CALL 

520 ST 

Monochrome. ..CALL 

520 STCoior CALL 

SHD 204 

20 Meg ! 

1040 ST CALL 

BRODERBUND 

Printshop 28 75 

Graphic 

Libraryl,li,lli,., 18.75 

Karateka 19,75 

Printshop 

Comp 24,75 

MICROLEAGUE 

Basebali 24.95 

GM Disk 24.95 

Team Disk 24.95 

Stat Disk 16.95 



MICROPROSE 

Siient Service. ... 22.75 

F-15 22.75 

Conflict in 

NAM 24.75 

Kennedy 

Approach 22.75 



UNISON 
WORLD 



ACCESS 

Leader Board. . . . 24.75 



SUBLOGIC 

■iightSimuialor.,, 29,95 



EPYX 

Karate Champ... 20-75 
Apshai Trilogy ..-24,75 



SSI 

WizerdsCrown,.- 24.75 

Gettysburg ,,34,75 

Gemstone 

Healer 24,75 

Phantasie 24.75 

ACTIVISfON 

Hacker 15,75 

GhostbusterB 15.75 

GreatAMRace... 15.75 
Music StLtdio ...22.75 



DISK DRIVE 

CLEANING KIT 

$8.95 

With Software 
SI 7.95 

"WE HAKE Wm COMPUTER 
FUN TO USE!' 



TOLL FREE 1-800-233-8760 



In PA 717-494-1030 
Customer Service 71 7-494-1 670 

1^' V—-.. or send order to ^^^ 

C'v'"'"' Lyco Computer ^f|J^ 

-"- - P.O. Box 5088 ■ 

Jersey Shore, PA 


shipping on prepaid cash O'dars ivilhiin the contm 
ble PA residens adfl sales la«. APO. FPO. and 
3% for priofily mail seivics. Advertised prices s 
lor MasterCard and Visa Personal checks require 
We do nol guarantee compatibility. We only ship I 
UPS Blue and Red label shipping Ali mercha 
warranty. Return restriction spplicaBie Relurr au 


r-Jo depcsit on C.O.O. orders. Free 

4 wee lis ciearance iietore shipping, 
clorylresh merchandise. Ask about 


1 

NEW HOURS 







STAC 



co^& 



\XA^ For Atari ST Computers 

No more spending thousands of dollars on an accounting package! For the price of some accounting packages alone, 
you can now purchase a full computer system that will satisfy your accounting needs and more. WHY!? 

- STAccounts is fast, powerful, easy to use, and affordable, 

- Fully integrated A/R, A/P, 1/C, and GA.. 

- All printed output/reports can be altered, amended, or entirely reconfigured to your specific needs utilizing the 
Report Generator. 

- Easy as a click of a mouse you can change from one module to another. 

- It's so easy to use. 

The combination of the STAccounts and the Atari ST Personal Computer will provide you with the solution to all 
your needs at an affordable price. 

VISIT YOUR ATARI DEALER TODAY AND FIND OUT FOR YOURSELE 



PARTIAL LIST OF FEATURES 

Accounts Receivable (A/R) - Integrated with A/P, G/L & I/C. 

• Account numbers and/or names ' Customers' names and addresses ' Invoicing/statements * 
Credit limit * 10 tax rates * Immediate account access * Bacltorders. REPORTS include Sales 
Turnover, Aged Receivables, Customer Statements and much more. 

Accounts Payable (A/P) - Integrated with A/R, G/L and I/C. 

• Account numbers and/or names * Suppliers' names & addresses ' Remittance advices/statements 

• Immediate account access ' Credit hmits. REPORTS include Purchase Turnover, Aged Payables, 
an Supplier Mailing List, 

Inventory Control (I/C) - Integrated with A/R, A/P and G/L, 

" 10 product groups * Turnover by quantity and value ' Alpha supported item lists * Inventory 

linked to A/P ' Editing of invoice information. REPORTS include Inventory Turnover, Price Lists, 

Inventory Re-order list, and Stock Report. 

General Ledger (G/L) - Integrated with A/R, A/P, and 1/C. 

■2i6 G/L Accounts * Immediate account access ' Account details including budgets ' Variance 

percentages for budget against actuals. G/L REPORTS include Profit and Loss Statement, Trial 

Balance, Balance Sheet and statement of accounts. 

Help 

STAccount provides you with on screen help through the use of TEDDY, a screen icon. If you 

become uncertain of your actions during the course of running the program, just click the left 

mouse button on TEDDY and a help screen for that particular section of the system will appear. 

Report Generator 

STAccounts Report Generator is a powerful tool integrated into the system. It will allow you to 

reconfigure reports using any of the system information. Provided with the system are a 

number of default reports which can be altered, amended, or entirely reconfigured for your 

individual company's needs, or create new reports as to your company requirements. 

SYSTEM CONFIGURATION 

STAccounts is designed fo be used with either a 520 ST or 1040 ST, 0.5 or 1.0 megabyte drive 
with a monochrome monitor. 
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TO ORDER AND FOR MORE 
INFORMATION CAIL 

1-416-479-1880 



U.S. ORDERS SHIPPED FROM US, 
NGN US, ORDERS SHIPPED FROM CANADA 



VIP MARKETING 

20 Steelcase Road, Init XI 
Markham, Ontario, Canada L3R 1B3 



D CHECK a MONEY ORDER 

D AMEX D VISA D MASTERCARD Expirf 



"n 



Account No. 
Name 



Company Name _ 

Address 

City 

Phone 

Signature 



STAccounts 



Silicon 
Soothsaying 



A Pro's Perspective 



i Y TIM O REN 



Prophecy, prognostication and logical prefiguration. Tim 
Oren gazes into his digital crystal hall, scanning past com- 
puters to predict the future of the Atari ST and its line of 
software. 



/n 1963. the TX-2 was the hottest computer at MIT. One of the hrst machines devoted 
to a single user, it boasted a Hght pen and a vector display capable of showing up 
CO I.OOO points at a time. It had less than 64 kilobytes of memory 

In 1968, an SDS-940 mainframe had 195 kilobytes of core memory, and shared its 
96 me^bytes of hard disk among 12 terminals, which were the first to be equipped with 
mice. 

In 1973, the Xerox Alto had 128 kilobytes of memory, and one of the first bit-mapped 
displays, U stored 2,5 megabytes of data on a removable 15" cartridge disk, and was dedi- 
cated to one user 

In 1975, the Altair,the(irst hobbyist computer, was built by MITS. A company named 
Atari released a ^me called Pong. In the same year, Gordon Bell, a designer with Digital 
Equipment, predicted the birth of the Atari ST. 

He didn't know its name, ot course, but he graphed the memory size and cost of 
machines like these, and noticed that the price of hardware was dropping by a factor of 
four every three years. By his schedule, the Apple I! appeared right on time in 1977, Since 
then, the rate of change has accelerated, resulting now in a one-rnegabyte machine for 
under $1000. 
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One result of this pattern, of course, is that you can buy- 
more and more power for the same money. A 1040 ST with a 
hard disk has more raw power than any of the machines 
listed above, 

. Another interesting result is that wc can predict the future 
of a series of computers by looking at what has happened 
with higher-priced machines. Similar predictions seem to 
hold for peripherals and programming as well. 1 am going to 
use this observanon to do some uninhibited speculation and 
exhortanon on what the future could and should hold for ST 
hardware and software. 

Hardware trends are fairly easy to predict, though how 
they will eventually fit into Atari's product lines is anyone's 
guess! Let's start with multiple processors. The next logical 
step beyond one computer per user is many computers per 
user Already, the many plug-in cards for PCs include MPUs 
such as Z8O3 or 6800s. Peripheral processors to handle 1/0 
for mainframes have existed for decades, and in 1986 we are 
seeing the advent of massive parallel processing in supercom- 
puters, with thousands of processors devoted to a single cask. 

The effect of this trend for the ST and other personal com- 
puters will depend on the availabihty of sophisticated 
CAD/CAM programs and fabrication iacilities for custom 
VLSI chips (Very Large Scale Integrated chips). This means 
that the "extra" chips will be tailored for functions such as 
graphics or I/O bus control, for example, the Intel 82786, the 
Amiga's graphics chips, and the rapid appearance of EGA 
(Enhanced Graphics Adapter) clone chip sets. Atari's pre- 
announcement of a "blitter" chip for the next ST is an ac- 
knowledgement of the trend. Atari owns such VLSI design 
equipment, and has some of the best designers in the 
business. 

The companion of multiprocessing is multitasking. (Multi- 
processing devotes more than one chip to a program; multi- 
tasking lets more than one program run at a time.) Multitask- 
ing is already useful to the single user for print spooling and 
background compiles. In the future, it will become more im- 
portant as the computer assumes the task of sifting through 
online systems and large databases for interesting material 
while the user continues to work. 

Multitasking is supported on mid-range workstations such 
as Sun and Apollo, and is now appearing on single-user PC 
systems. While multitasking is largely a software problem, it 
requires some hardware support, in particular a memory 
management unit that keeps one errant task from destroying 
the others. The conflicting demands of multiple tasks also re- 
quire hardware or software locking capability for peripherals 
and data files. 

We can take it for granted that new machines will con- 



tinue to have more memor}'. Four megibytcs ior a next gener- 
ation ST seems easily in sight. Developers will, of course, 
quickly consume it and ask for more. The way out of the 
cycle is to introduce something that has existed for years on 
mainframes: virtual memory. If I am using a VAX and need 
200.000 pointers to articles in a CD-ROM database, I can sim- 
ply say: 

long int art_locs[200000]; 
because it automatically handles the paging of my address 
space from RAM to disk. If I am using an ST, I must write an 
entire memory management scheme from scratch to accom- 
plish the same task. The use of virtual memory implies a 
whole new layer of page-fauh detection hardware, optimal 
caching logic, and so on. It also mandates the inclusion of a 
last hard disk as part of the system. 

PERIPHERALS 

As the bandwidth of the basic microcomputer rises, the abil- 
ity to transfer information to and from the user becomes 
limiting, and critically important. While using specialized 
chips to drive graphics and sound will help, other compo- 
nents are just as critical, (Bandwidth is the rate at \vhich a 
processor or data channel can move information. Put simply, 
how fast can you push the bits?) 

Any programmer who has complained about running out 
of screen space recognizes one of these limits. Space to dis- 
play information is at a premium, but help is on the way Up- 
right, page-sized monochrome displays with 100 dot-per-inch 
resolution will be the graphics device of choice for the next 
generation 

Contrasting with the need for a tableau of information is 
the desire for a visually intense, natural presentation for color 
graphics. Experience with displays like the AT&T Tar^ indi- 
cates that the number of displayable colors is more important 
than resolution for such uses. Given this dichotomy, the ST's 
choices of monochrome or color modes can be seen as for- 
ward looking, not a retrogression. The either/or plug will have 
to go, though! 

The most ruinous limitation in peripherals is the low 
bandwidth of user input devices. Conventional keyboards, 
joysticks, and mice have hit their limits, even given good user 
interface design. As evidence, 1 offer the continuing debate 
between the devotees of one-button and two-button mice. 
The subject of this religious warfare may be recognized as an 
example of "overloading," in which one symbol or action 
(point-click) is made to carry more than one meaning. Over- 
loading is usually a sign of a severe design constraint, in this 
case, the limitation of the mouse to pointing In a two- 
coordinate plane. ► 
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"lo break out of this bind, input devices must have more 
degrees of freedom, Tfiere seem to be two ways to get this. 
One is to take the keyboard approach, relying on the flexibil- 
ity and trainability of the human mind to indicate its desires. 
Along this path lie MIDI keyboards for music input and 
pressure-sensitive touchpads with gesture recognition pro- 
grams and software-definable control areas. 

The second approach is to instrument or observe the hu- 
man body and let it behave naturally, moving in a virtual 
space defined by the computer's display (which might be 
viewed on a video projector). Researchers at MIT and the 
University of Connecticut have taken the tack of obsewing 
the movements with TV cameras, and extracting the relevant 
features. Limits in pattern-recognition methods, and the costs 
of such processing and the associated video gear, probably 
mean that it will be at least two generations before the com- 
puter will be watching us watching back. 

For the short term, a significanf breakthrough is the an- 
nouncement of Jaron Lanier's "Glove," a device that is able to 
take independent input from five fingers as well as three- 
dimensional positioning, (See Infoworid,June 9, 1986.) Not 
only does this more than double the possible input band- 
width, it has profound implicadons for the design of virtual 
3D workspaces. The continuing development of miniaturized 
strain ^uges, accelerometers, and nonintrusive biomedical 
pickups for military uses says that the Glove is just a starting 
point. 

The third trend in peripherals is the continuing merger of 
the computer into other forms of media, as correctly forseen 
by Alan Kay ten years ago. Sound and animation editors have 
progressed from toys on 8-bit machines to near professional 
quality in the current generation. The next generation will 
complete this trend, and begin adding hardware for integrat- 
ing digital television into a total multimedia authormg and 
playback environment. 

Already computer power is being merged into a media 
standard as part of the Sony/Philips CD-I system. The ST's 
MIDI ports are an important toehold in this new world. Image 
scanners, frame grabbers, and genlock components will be 
needed next. Sorr)', the oddball scan frequencies have to go, 
too. 

Finally, the ability to access massive quantities of informa- 
tion will explode. CD-ROM for the ST, though much delayed, 
will become a reality, giving a desktop machine 200 times the 
data capacity of the Xerox Alto. It may also include the ability 
to retrieve sound tracks, computer graphics and video images. 

The second part of this revolution, online communication 
and data retrieval, is well under way. Anyone who reads 
ANTIC ONLINE on CompuServe, who uses a computer bulle- 



tin board, or subscribes to Dow/Jones news ser\'ice is already 
participanng, A shakeout in this market is inevitable. Victory 
may go to the services that are best able to integrate their in- 
formation with other sources such as CD, and with the 
microcomputer user interface. 

An important question is how ST owners will get all of 
these goodies. Atari isn't large enough to develop them all. All 
this will be determined by the ST's fate in the marketplace. 

The market for computer hardware and software add-ons 
is beginning to resemble that of 'bolt-on" accessories for 
autos and aircraft. Given a wide variety of basic machines, a 
manufacturer will produce for those with the greatest distri- 
bution, with suitable mountings for accessories, and stan- 
dardization across models. 

The first "bolt-on" machine in microcomputers was the 
Apple 11. It was followed by the IBM PC, and now the AT. Ap- 
ple moved up to the Macintosh, but forgot to put in the bolt 
holes. They are now correcting this oversight. The true com- 
petition between the ST, the Mac, the Amigi and other com- 
puters is for acceptance as a "standard airframe^' worthy of 
software and hardware investment. 

SOFTWARE 

My choice oi example hardware at the beginning of this arti- 
cle was not accidental. The systems described were used to 
produce: 

* Sketchpad, the first graphics editor, written by h'an Suther- 
land in 1963. 

• NLS/Augment, the first "idea processor" developed by 
Doug Engelbart at SRI. 

' Smalltalk, the windows-style interface, digital typefonts, 
Markup, and a host of other seminal applications by the Xe- 
rox PARC team. 

Although our hardware today is superior to each of those 
systems, our software is markedly inferior to all of them, in- 
cluding one over two decades old! What has gone wrong 
here? 

Part of the answer is quite natural. Minds that can produce 
such works do not stay long in the same place. They move on 
to new ideas that can be implemented on the ever-evolving 
hardware base. The transition of the ideas to the next lower 
class of hardware is left to other programmers, other compa- 
nies. If their vision is less clear, if their resources are limited, 
the results may be a pale imitation oi the original. 

The exigencies of business promote this, too. As the price 
of the base hardware drops, the price obtainable for its soft- 
ware drops as well. Since the effort to implement the software 
stays largely constant, a company must spread its costs over a 
large number ol units sold, or it will be very dead, very 
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quickly. This environment does not encourage risks on radi- 
cal departures in software design, even if [he concept has 
been proven on larger machines. 

The same observation apphes to hardware companies, 
since they have assumed the role of supplying operating sys- 
tems and graphics software with their machines. The high 
prices of Apple computers are a direct reflection of that com- 
pany's choice to invest in transfer and development of soft- 
ware technology. High development costs require high 
margins. 

Atari is a different story, of course. When aiming for low 
price you do not invenc-you rent. The innards of an ST are a 
roadmap of the company philosophy. Virtually ever;' part is 
off the shelf, except for a few custom chips carefully op- 
timized CO replace the maximum number of components. 

The software is the same. GEM and the rest were off the 
shelf from Digital Research. Atari wrote hardware drivers, 
made sure that some key applications were in place, and shot 
It out [he door To expect software leadership from Atari is 
unrealistic. Those who complain about lack of such support 
are wasting their time. It is simply inherent in the company's 
structure and position in a low-margin market. 

This would all sound rather gloomy, but there is a way out. 
Outside developers, professional and amateur, can fill the 
need for good software, and be rewarded for doing so. To 
avoid the problems I've talked about, we have to keep a clear 
eye on two principles: leverage and idea transfer. 

LEVERAGE 

Leverage is making sure that your efforts pay off more than 
once. When dealing with software, leverage is spelled 
T-0-O-L-S. If you build the proper tools, you only pay that 
development cost once when you begin working a vein of 
good ideas. The rest comes free. Here are a few things I think 
we're going to need. 

Tools come in many flavors: languages, libraries, utilities, 
and design and prototyping aids, to name a few. The basic 
languages for the ST are in place: C, Pascal, and assembler, as 
well as less known languages like Forth and Modula, 'What we 
need now are incremental compiling versions of these tools, 
with test runs conducted within the language environment 
This is the way to break the interminable edit-compile-link- 
run-crash -debug cycle Not only will this relieve frustration, 
but better applications will result from greater freedom to 
experiment. 

Another big need is object-oriented extensions ol the basic 
languages. ST implementations similar to the Macintosh's Ob- 
ject Pascal, the PCs Objective C, or Bell Labs' C+ -f would 
make it easier to implement good ideas borrowed from the 



Smalltalk wotld. The current ST models don't have quite 
enough power to run the most recent versions of Smalltalk it- 
self, but this would be a good time to look at that language 
with an eye toward creating useful subsets, or transferring 
more features to other languages or applications. 

Reusable source programs for GEM started with the DRI 
DOODLE program, which was more of a stock of plagiariza- 
ble code than a true library. Since then, a good deal of modu- 
lar code has been inade available through the CompuServe 
data libraries, due to contributions from Atari, DRI, and other 
developers, and as part of my own columns on ANTIC ON- 
LINE. A logical next step would be to collect, codify, and ex- 
tend this material and make it more generally available. 

We also need a better skeleton application than the DOO- 
DLE program, which omits many important techniques. The 
best step would be in the direction of Apple's MacApp, which 
hides the basic event loops as part of system-level methods. ► 
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Lacking the Object Pascal base on which to build such a sys- 
tem, a next best approach would be a standard top-level 
skeleton, with a source-code library of plug-in modules for 
such functions as drag recognition, window scrolling, and so 
on. 

Linkers and debuggers are examples of tools I call "glue." A 
soLirce-code-Ievel debugger should be a part of any reasona- 
.bly integrated development environment. Such a tool must 
also allow data to be examined in the context ol its structural 
definition, not as unrelated bytes. 
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Leaving aside such long-range hopes, the single most use- 
ful bit of glue at this point would be a good incremental 
linker/librarian capable of handling both major ST object- 
module formats: Alcyon/Megamax and Lattice/GST. DRI's 
L1NK68 is notoriously slow, and only handles one of these 
formats, A good implementation would produce a partially 
hnked output, and then add any changed modules just before 
production of a loadable binary. That way, you only pay over- 
head for the code you have actually changed. 

The Resource Construction Set is the first interface design 
and prototyping tool for the ST, There are a nurnber of direc- 
tions in which this notion could be improved and expanded. 
One would be adding real-time demonstration features, so 
that an entire interface could be shown in action, as well as 
created. Dan Bricklin's Demo Program is an example oi this 
concept, executed in alpha mode on the IBM PC 

The current RCS objects and editing rules mirror the capa- 
bility of the AES library code Graphics-code libraries effec- 
tively extend the AES with new capabilities-^The creators of 
such libraries could also build an enhanced RCS which incor- 
porated new objects and rules to go along with the new func- 



tions. If 'the program was made extensible, using such 
methods as template objects and rule tables, end users could 
continue to augment the AES themselves, 

IDEAS 

In last issues Perspectives, Dave Small quoted the program- 
ming axiom: "Steal from the best'! 1 couldn't agree more. As 
you might guess, I find the picking best when I look for 
ideas that have fallen between the cracks, or that haven't had 
time to appear on the latest machines. Another source often 
overlooked by "serious" designers is microcomputer ^mes. 
There's not enough room here to do justice, but the following 
are some highlights that I think deserve attention. And 
remember what The Great Lobachevsky said. , ."Plagiarize!" 

Graphics Editing and Visua! Programming- There are at least 
three good ideas in Sutherland's Sketchpad that haven't 
shown up on micros yet. One is the notion of active handles 
on the graphic objects, allowing them to be "glued" together at 
specified points. For instance, a resistor symbol would have 
two external points of attachment. There was also the ability 
to combine multiple objects into a group, effectively defining 
by example a new class of objects with associated handles. Fi- 
nally, Sketchpad allowed the entry of constraints such as par- 
allel, coincident, and congruent to be automatically applied to 
the graphical elements. A more recent example of a constraint 
oriented graphics editor, with an improved user interface, is 
the Juno system developed at Xerox PARC 

Constraint-based editing is really an example of visual 
programming, in much the same way as PROLOG is a non- 
procedural way of implementing rule-based systems. Alan 
Borning's Thinglab program makes this aspect more explicit. 
There have been many attempts to implement procedural vis- 
ual programming, with wide variations of success. One of the 
most interesting results is a ^me for the Macintosh called 
Chipwits, which uses a visual language to program a simu- 
lated robot. For more pointers to visual pro^mming ideas, 
see Myers' article on this topic, Usted below. 

New Ways to Think- Engelbart's NLS system was the eadi- 
est and maybe the best implementation of a hierarchically 
structured "idea processor' It incorporated several features we 
still lack, such as the ability to work cooperatively, and mix 
video images of the participants with the computer output. 
For those who like a free-form tool, Ted Nelson's Hypertext 
ideas of linked dynamic documents are attractive. At 
KnowledgeSet, we have been building a Hypertext system 
based on static documents stored on CD-ROM, The work go- 
ing on at Brown University is even more exciting because it 
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combines several information sources in a dynamic hypcrmc- 
dia framework. One of the biggest upcoming challenges is 
finding meaningful ways to navi^te in such massive 
databases. 

MicrowoiWs-Smalltalk is still the best platiorm \av making 
microcosmic simulations because it provides explicit 
mechanisms for creating types of objects and defining the 
ways they interact. Since Smalltalk has not been practical on a 
micro, the most interesting microworlds have been created by 
gime designers. Bill Budge's Pinball Construction Set was the 
mspiration for the Resource Construction Set, and is superior 
in that It animates the results of the construction. The con- 
struction set metaphor has proven very popular on the 
Macintosh, being put to such diverse uses as animation, mu- 
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sic, and calculators. A recent extension is the association of 
■'field rules" with areas on the display, causing objects placed 
into an area to conform to predefined constraints. 

Going Media- We are just now getting decent ST programs 
for editing text, static graphics and MIDI sound. The Audiolite 
presentations, available by using The Music Studio and Paint 
Works from Activision, give some idea of the results possible 
when these capabilities are mixed in a limited way. One of 
the hottest possibilities with the ST is to create an editing and 
playback system which integrates all of these data types and 
adds animated graphics, or eventually, images from a video 
source 

ENVOI 

The ST is a machine with an incredible amount of potential. 
If you have been feeling cramped by your old 8-bit machines, 
kick back and enjoy your new freedom. There's no need for 
individual developers to rebuild the same old programs; there 
are plenty of commercial or^nizations who will take the safe 
road and do just that It's time to raise our sights, and realize 
how {av we can go with some new ideas and a little carehi! 
engineering. ■ 
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It's a challenging new game in 
which the players take turns 
creating words on a playing 
board. Here's what reviewers 
have to say: 



"...the whole game design is extremely user- 
friendly. . .a winner." analog computing, June 1986 

". . .It's easy to use the mouse to design and save 
your own board layout. ..makes the game even 
more fun." antic, Apni 1986 

". . ./ am very impressed with Word for Word. . .full 
utilization of GEM. . .solid performance. . .a joy to 
play . . .attention to detail. . .excellent product." 
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IBM to ST 



BY MARK SKAPINKER 



When Digital Research first introduced GEM, the big draw- 
ing card was the ease with which developers could port 
graphic-oriented software between different processors. Just 
how easy is it? Mark Skapinker of Batteries Included 
describes his experiences developing "trans-compatible" 
software for the IBM PC and the Atari ST. 



I M #hen Batteries Included decided, in March 1985, to develop the ISGUR Port- 
MMmM folio System for MS-DOS using a graphics interface, GEM was the only major 
■ W graphics system available for the IBM PC. Since we also knew it would be- 
come the interface on Atari's new ST computer, GEM was the natural choice for our soft- 
ware development. 

THE TEAM 

We established an in-house GEM development team in our Toronto offices, consist- 
ing of myself; Chris Bailey and Steve Couchman, our software engineers; Keith Hope, 
hardware engineer; Lloyd Speyer, tester; and Mike Reichmann, president of BI (with 
a special love for software development). Since the ST was not then available (and 
would have inferior development tools when it did become available), we decided to 
create our software on the IBM and port later to the ST We have since developed- 
and are continuing to develop -a number of ST GEM applications using the MS- 
DOS / IBM PC environment as a host machine, 
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Chris Bailey, a hacker ai heart, volunteered to dive into the 
depths of GEM and become the "GEM resource person" for 
both us and our outside developers. To accomplish this, he 
undertook two projects. First, since some people don't like 
mice, we wanted our GEM programs to be able to activate 
drop-down menus via the keyboard- By pressing a given 
function key, you would get a menu dropdown to fall, and by 
pressing the first letter of an item description, you could acti- 
vate that element. Secondly, we needed a tool that would let 
us to use the GEM play and record functions (appI_record 
and appl_play) in a more usable and efficient manner than 
was provided with the GEM toolkit. As is typical with pro- 
gramming, these two tasks proved much more complicated 
than expected. 

We discovered that once a menu item has been selected, 
control of the mouse is handed over to GEM exclusively, so 
how could we then see which key was pressed? Our solution 
was to have a desk accessory running that would look for 
keys at that time (since desk accessories could run as a sepa- 
rate task at the same time as a program). Thus, the desk ac- 
cessory would intercept keystrokes from the keyboard at the 
time that the dropdown was lowered. Elegant, but compli- 
cated to say the least! 

3ppl_record and appl_play should allow you to "record" 
mouse and keyboard movements then "play" them back at a 
later stage. Chris found these functions (particularly appl_ 
record) very inefficient. For example, it might take 500 bytes 
ol storage space to record a mouse movement across the page. 
Add mouse positions and timers and it becomes very large. 
Fie decided to write his own, more efficient version of these 
functions, which we called replays. Eventually, both replays 
and the function key accessory were combined into one desk 
accessory. 

While Chris explored GEM, I be^n developing the ISGUR 
Portfolio System and was able to devote my rime to the appli- 
cation side of the project, Steve Couchman joined us as our 
communications expert and be^n developing l*S-Talk under 
MS-DOS GEM. He also agreed that as soon as the ST was 
available to us, he would become our ST expert. 

In the meantime, Keith Hope performed magic on our MS- 
DOS machines. He added a 80286 board with two megabytes 
of RAM disks, cache memory, and a 40 megabyte hard disk to 
my Compaq The Intel 80286 chip is the same processor 
found m the IBM PC AT, only this one ran at nine MHZ in- 
stead of six. The cache memory allowed the original 8088 
chip in the Compaq to efficiendy determine whether to ac- 
cess the disk for data, or whether the data was in memory al- 
ready, thus cutting down on disk I/O. This eilectively ^ve me 
a machine running 10 to 20 times faster than a regular IBM 



PC and gave us the freedom to concentrate on developing 
software. Truly a developers' heaven. We have become quite 
spoiled from all these hardware tools, as well as the myriad of 
MS-DOS software tools (l^attice C, Phoenix's linkers, debug- 
gers. Lints, etc.) which are very sophisticated, bug free, fast 
and reliable. 

EARLY ST 

when the ST arrived later in the year, we knew we should 
start developing for it as soon as possible. But we were faced 
with a machine with almost no software tools, let alone fast 
hardware peripherals like hard disks. Pioneer ST developers 
will remember those amusing early version numbers: C 
compiler version O.F, linker serial number 0000-AAAA. The 
time was ripe for system software to be developed on the ST. 
We knew that if the machine was to survive, it would need 
some useful application software reasonably quickly We 
decided to immediately try our hand at porting ISGUR Portfo- 
lio System and TS Talk. Steve spent two weeks with the in- 
adequate tools provided with the early ST- overflowing his 
floppy disk space, crashing. He later realized that he accom- 
plished about as much in those two weeks as he now 
achieves in two hours. 

After some frantic calls and long meetings, we decided to 
take a different approach: We would become GEM experts 
and concentrate on developing superior GEM applications 
under MS-DOS. At the proper time, we could port our code to 
the ST and make the necessary changes to take full advantage 
of the Atari hardware, in the meantime, Steve became a beta 
tester for everything we could find on the ST. He spent count- 
less hours trying every compiler, linker, editor and got to 
know eveiy available piece ol systems software for the ST. The 
creative development environment was becoming a faistrat- 
Ing environment. 

To make the IBM-ST port as straightforward as possible, 
the decision was made to develop our software in the C lan- 
guage. C is well known as an ideal language for cross develop- 
ment purposes. We opted for the Lattice compiler on the IBM 
because it was well suited to GEM, we had experience with it, 
it supported full C, and it was a mature system. Also, the de- 
velopers at DRI had used Lattice to develop the GEM bindings 
and therefore recommended it. We also wrote our code in a 
structured, modular fashion-all data definition and machine 
specific codes were external, all 1/0 was localized in one po- 
sition. Using C, we were able to write code that referred to ex- 
ternal functions -such as memory allocation and l/O-in a 
very logical manner (We found the header files PORTAB,H 
and MACHINE, H to be very useful in this re^rd,) We were 
determined to write code that would behave itseil under ► 
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GEM; it is very easy to write non-standard code. Wc wanted 
to behave first-ihen, at a later stage, fine tune the code lor 
speed. 

We were fortunate to be provided with an excellent role 
model, BI's only ST software at that time was DEGAS (an out- 
side acquisition from Tom Hudson). Its sales were better than 
anyone ever imagined. Within the first three months, we sold 
more copies of DEGAS than we expected to sell in the first 
year We also found our international sales very significant. 
Other developers seemed lo be finding ST sales to be a bit 
tough. This proved to us there was a strong market for solid, 
well written ST products, and that it was very worthwhile to 
develop other powerful ST programs. 

After fall Comdex, we decided that the STs time had come 
We elected to port the ISGUR Portfolio and l^S Tilk over to 
the ST 

ST TOOLS 

There are now some good hard disks for the ST and some us- 
able development software has started appearing. The situa- 
tion is improving rapidly, but some of our biggest frustrations 
are rooted in not knowing what to blame for a bug. When we 
were porting the ISGUR Portfolio System from MS-DOS, we 
had almost one me^byie of source code to transfer! We 
decided to use the Megamax C compiler on the ST side It 
seemed a solid, fast and quite efficient compiler 

Me^max compiled our code very quickly, but the system 
sometimes crashed during the link. Was our code too large? 



We decided to 

create our software on the IBM 

and port later 

to the ST. 



Were we passing some limits? Eventually we and Megamax 
discovered there was a problem in the memory allocation of 
the linker. We used this frustrating opportunity to fine tune 
our code and manually perform a hnt, (Lint is a program that 
examines C code for correct syntax and structure. Under MS- 
DOS we could simply have used such a program The closest 
wc could get on the ST was to manually go through the code 



line by line.) Megamax had presumed that TOS would allocate 
memory as documented; this was not the case. (With TOS, 
each time you request memory, you must free it. Otheru'ise. 
alter a certain number of memory requests without "free-ups," 
you will bomb. One solution is to determine in advance your 
total memory needs and request it all at once.) 

The port for our two programs was fairly 
straightiorward-which is not to say that it was completely 
simple. Under MS-DOS, one can choose which "model" to 
develop under This is not true for the 68000 machines. A 
model in the 8086 processor indicates how large program 
and data address space should be (and thus the compiler cre- 
ates two or four-byte pointers). The 68000 only uses four- 
byte pointers. Structures not byte aligned under MS-DOS had 
to be reconsidered. Structures were forced on to positive 
bytes, thus changing their sizes. But thanks to the portability 
of C, the incredible similarities between MS-DOS and 
GEMDOS, and the similarities of GEM in the two environ- 
ments, it was not too bad. Where no GEMDOS call existed, a 
close approximation could always be found. On the other 
hand, MS-DOS is far more forgiving if you ignore directory 
paths in I/O operahons. (For example, MS-DOS will accept 
A:PILE,DOC, while GEMDOS insists on A:\FILE.DOC). 

THE SIX WEEK PROGRAM 

In March 1986 my wile and nine-month-old daughter went 
to Israel to spend six weeks with my in-laws. For myself, 1 
saw the opportunity of six weeks in which to develop an ST 
product. Having come from the MS-DOS world, I knew just 
how successful add-on memory resident tools-such as 
Bodand's Sidekick, and Lightning- were on the IBM PC, BI 
had already created BatteryPak, a set of useful desk accesso- 
ries for the Macintosh which was doing well. With GEM, we 
also had the desk accessory capability available, 1 am a terri- 
ble speller and find a spelling checker vital to my work. 1 did 
not want to develop "just another spelling checker' so I began 
planning the ideal writer's tool for the ST. My only restraint 
was lime. I needed to hnish the bulk of the project in six 
weeks, and was determined to be completely finished before 
the 1986 Summer CES. 

I also had some hopes about the effect of this product on 
the ST world. My responsibilities at BI include looking at the 
marketplace, tr)'ing to understand where things are going, and 
trying to create a market environment that will help such 
machines as the ST to succeed in a big way. I have looked at 
all the software coming out for the ST and am convinced that 
the only way the ST will succeed is if a consistent interface is 
used for all of its programs. What will revitalize the home 
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computer marketplace is a common interface like that found 
on other consumer products such as cars, stoves and TVs, We 
have the GEM interface and, for better or for worse, we shoukl 
make it work for us all. 1 hoped products like Thunder! 
would motivate other ST developers to follow the rules in de- 
veloping well-behaved GEM applications. Accordingly. I 
decided to develop a program chat would work with any wcU 
behaved GEM ST product. 1 just hope that we are not all hurt 
by some of the eariy applications coming out for the ST- it is 
not good enough to ship piles of software if they are not of 
decent quality. Some early GEM programs, for example, leave 
"holes" in the screen after desk accessories have been acti- 
vated. Ultimately, such programs will not be worthwhile and 
linancially they will fail. Enough preaching. 

i decided the only way I could develop the system in six 
weeks was by developing a bug-free program on my Compaq 
under MS-DOS GEM, and only then porting it over The big 
lesson 1 had learned from our first ports was to develop just 
the "core" under MS-DOS, test it thoroughly, port it to the ST, 
then develop that last ten percent of the project (which al- 
ways seems to take fifty percent of the lime) on both 
machines simultaneously. This way, I would know the code 
worked before it got to the ST, The core of the program for me 
was a working, efficient version of the program that lived well 
in the GEM world. Any bugs would be easy to identify and 
(ix Once on the Atari, I could spend time making the code 
ST'ish. 

THUNDER! 

Thunder! is made up of two programs: a real-time desk ac- 
cessory which we initially called Thunder, and a stand-alone 
program, which we were calling Bolt at that time (Thunder- 
bolt), The user interface is written mostly in C, with the key- 
board interrupts and the dictionary lookups written in as- 
sembler. The dictionary consists of 50,000 words intricately 
sc(ueezed into 80K. These are 50,000 real words; thus walk, 
walks, walked and walking are considered one word, effec- 
tively giving many more than 50,000 words. 

The desk accessory part of the program looks up words in 
the dictionary as they are typed in. The program thus inter- 
cepts keys Irom the keyboard as they are typed in. These key- 
lioard interrupts were reasonably close to the way we had 
previously handled our function keys accessory, so we al- 
ready had the basic routines in 8086 and 68000 assembler 
We had the dictionary routines in both assemblers as well. 
Thus, we were able to develop the C routines independendy 
of the assembler routines. 

On the 8086 side, we used l-;irtice C small model (data 



and program less than 64k) to create eOicient code We were 
determined to maintain only one set of source code; the same 
program would be maintained for both machines. We could 
do this very smoothly by using the MACHINE. H and POR- 
TAB,H files supplied by DRI. MACHINE.H is a header file 
written by Digital Research that defines machine specifics 
about routines used by some GEM routines, such as defining 
of the size of ADDR pointers, PORTAB.H defines variables 
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such as BYTE, WORD, BOOLEAN, and LONG which were 
used instead of char, int etc. By using these header files, our 
code became very portable between the two machines. 
Where specific code was needed for a particular machine, we 
simply defined PCD05 or MC68K in the header files and 
used, #ifdef statements. 

An example of the #ifdef statement in using the OS- 
BIND.H file would be; 

#if MC68K #include "osbind.h" #endif 
or even defining the name of the main module: 

#if MC68K mainO #else GEMAINO #endif 

For the first four weeks, 1 developed the program on the 
MS-DOS side only Because of the speed of our tools, a nor- 
mal compile-link-run GEM cycle would take about two to 
two-and-a-half minutes. For a program of about 40K object 
size, this was incredibly useful. It let me add a new routine or 
function and test each part almost immediately. Productivity 
in these four weeks was thus incredibly high, and by devoting 
some very long days, nights and weekends (wow, there goes 
spring!), ! had the basic core finished in four weeks. 

Now came the unknown; How long would it take to port it 
over to the ST? We- mostly Chris- had been working on the 
ST assembler routines and had already debugged most of ► 
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tlicm. Stc\'e had poricd most of I*S Talk ovlt by then, and 
was ve\y familiar with memoiy allocation and the I/O rou- 
'.ines from the Atari developer's document, "Hitchiker's Guide 
to the BIOS" Because of the way Megimax handles (or rather 
doesn't handle) assembler interrupt routines, we decided to 
develop the stand-alone program under Megamax C, and the 
desk accessory under Alcyon C. Interrupt routines can hap- 
pen at any time and use any ol the 68000's registers. Mega- 
max uses these registers to access GLOBAL variables. Megi- 
max can be used if you keep saving and restoring your 
registers but, as fast and efficient as Megimax is, the over- 
head, in this case, was not worthwhile, 

THE PORT 

With Steve and Chris' help, we be^n our port one morning at 
9:00 am. We were really amazed when, by noon we had the 
stand-alone program running on the ST. We used Tim Oreris 
resource mover to smoothly move the resources across, 
changed our MS-DOS 1/0 calls to GEMDOS calls, and recom- 
piled. Using Me^raax, it all worked first time! (Editor's note: 
Tim Oren's resource mover is availabkjor $25. You can reach Tim 
through his CompuServe PPN# 76703,202.) 

That afternoon, we began porting the desk accessory. This 
was more of an unknown; the two machines handled desk 
accessories in different ways. On the ST, a desk accessory is 
loaded at boot time, while under MS-DOS, it is loaded when 
you Starr GEM running The port was smooch, and by the 
next evening we had the desk accessory running on the ST 
The mam reason for the delay was the incredibly slow com- 
pile and link speed of the Alcyon compiler The Me^max 
compiler was about six to seven times faster than the Alcyon. 

Over the next four weeks, we were able to fine tune Thun- 
der! to take advantage of all the special features of the ST, in- 
cluding different resolutions, color and speed We did this for 
the MS-DOS environment as well. 

At first we used Kermit to port the code, but we have since 
found an easier method. Just hook up a 3 I/2-inch drive to 
the PC, (It helps to have someone like Keith Hope for this.) 
By using any of the versions ol MS-DOS made for the new 
portables (like Toshiba TllOO), you lormat the disk on the 
MS-DOS side with FORMAT/3, which will make the disk 
720K format- Incredibly, we found that the disk is completely 
recognizable by the ST, Now that better tools exist, you can 
also port easily with communication software such as TS 
TALK, FLASH or HOMEPAK. 

With the help of Ian Chadwiek's documentation, Marty 
Herzog's art direction and our in-house desktop publishing 
system, we had the program completed and packaged by June 
1st for the summer CES. Chris finished his function keys and 



replay routine on both the MS-DOS and ST machines, and 
they are proving very useful We have since decided to pub- 
lish more than twelve ST products this year-by both outside 
developers as well as in-house, 

CRAWLIES AND OTHERS 

The most frustrating parts of the exercise were the "idiosyncra- 
sies" (a euphemism for little crawly creatures). Here follow 
some examples, tips and hints from our experience: 

It is hard to keep to the rules when you find that your 
desk accessory is suddenly 40K bigger than it should be. Yes, 
it is true, Open a virtual workstation in a desk accessory and 
it allocates the 300-400 bytes of memory it needs somewhere 
far away from where it should, A temporary solution is only 
to open the workstation when necessary. 

If you use a regular form_do in a desk accessory, you may 
find that your keys fall through to the application, so be pre- 
pared to write your own. By "falling through", I mean that if 
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you have a desk accessory on top of a word processor for ex- 
ample, keys pressed during a form in the desk accessory are 
picked up and used by the word processor 

evnt_timer is a very dangerous call to make from a desk 
accessory. It sometimes causes the entire program to freeze 
up, (This one is true under MS-DOS as well, which has its 
own big list of idiosyncrasies.) 

Before doing an fsel_input ca!l-and before any I/O- 
make sure you have correcdy set path names. (A: is not good 
enough, it must be A:\,) 

The documentation for vex motv is wrong— it requires a 

jump to the saved address to update the driver 

form_alert strings can only be about 30 characters per 
line 

You should modily the source of form_do (form__keybd) 
to change underscores to dashes. Underscores blow your ap- 
plication out of the water 

appl_play and appl_record do not work without a ROM 
patch from Atari, (Editor's note: According to Atari, this code is 
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available to developer's only. CoiUact Atari on the Ataii 16-bU SIG 
of CompuSef'vc.) 

COMPILER PROBLEMS 

Alcyon: appl_init returns the wrong value (alu'ays returns 1). 

Bindings tor form_keybd and form_button are missing. 

Me^max: No overlay linker support. 

The most irritating part of the two compilers are that they 
have incompatible file formats for object code. 

AND YET MORE CRAWLIES. . . 

At June CES, we showed the first version of Thunder! before 
actually shipping it. This was fortunate, because Murphy 
struck a^in. We discovered that the program would suddenly 
freeze up and the menu would stop working altogether After 
some frantic tests, we found that the timer problems were 
even more serious than we thought. Nor only should you not 
do any evnt_timer calls, you should not use MU_TIMER in 
your evnt_multi calls or have any reference to timer calls 
anywhere in a desk accessory. We replaced all these refer- 
ences with different evnt_muki calls and everything became 
stable once again. And then, another surprise. The newer ver- 
sions of 1ST Word do not allow the Backspace key to buffer 
characters. (When you hold down the key, it does not auto 
repeat). 1 presume they did this because the machine is so 
fast the user might delete too much of the document. This 
caused problems in the speed that Thunder! deleted charac- 
ters, so we added an option to delay backspaces for such 
problems. (Who would believe that someone would write 
software to slow down the hardware!) 

As time passes, it makes less and less sense to develop 5T 
software on an IBM (unless you are developing for both 
machines simultaneously). As tools on the ST become more 
mature, and developers become used to the idiosyncrasies of 
the machine and the tools, (and these idiosyncrasies become 
documented), it becomes easier to use the ST for its own de- 
velopment. The tools are almost available (the new Me^max 
compiler compiles faster than my Compaq in 286 mode). 
Soon, we can expect other tools like Lint, some good debug- 
gers, and, most importantly, the confidence that these tools 
work as they should. Let us hope our period of frustration is 
almost over The time for development of good application 
software for the ST is here. Only, please, make the effort for us 
all-and make it good GEJvl-based software. ■ 

Batteries Included 
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LEARN THE SECRETS OF YOUR FLOPPY 



by David Sma 



L 



jump right in. 



Di-skettes are magnetic stor- 
age media. In other words, computer 
bits arc stored as magnetic fields on the 
disk. The actual diskette surface is just 
iron goo that can be spot magnetized, 
veiy much like cassette tape. Unlike cas- 
sette tape, which stores music as a 
var)'ing-iniensity magnetic field (ana- 
log), the diskette only has two types of 
magnetic fields which correspond to ci- 
ther a zero bit or a one bit (digital). 

The data on the disk is a series ol 
magnetic fields lined up end-to-cnd. 
Imagine about 48,000 bar magnets, each 
with north and south poles, lined up 
end-to-end around a track and you'll 
have a fair idea of what the fields look 
like on a disk. Because some of these 
magnets are pointed in one direction 
and some in another, the combination 
of poles- N/N. S/S. N/5, S/N - creates 
var)'ing magnetic fields. As the dri\'e 



M^ avid Small, creator of the MacCarfridge, and 
Atari hacker supreme, waxes eloquent on the sub- 
ject of ST floppies and the Floppy Disk Controller. 
This is a thorough, technical exploration of the sub- 
ject, but even beginners will gain some knowledge. 
To get the full benefit of this article, a familiarity 
with hardware, hexadecimal, and assembly lan- 
guage is helpful. On your START disk, inside the 
TRAKREAD.STQ folder, is on assembly-language 
disk reader which demonstrates programming 
techniques for the Floppy Disk Controller. 



head passes over the disk, the head 
senses these magnetic field tmnsitions, 
or changes, and that is how the data is 
recorded and reread. 

A 31/2-inch ST diskette consists of 80 
tmchi. Each track is one circular path 
around the diskette at a certain radius, 
and at 135 tracks-pcr-inch. those tracks 



are ver)' closely spaced! The outermost 
track is number zero and the innermost 
track is number 79, 

There is a head in the disk 
read/write mechanism that moves in 
and out along the tracks. Once the head 
is settled on a given track, the disk 
spins underneath but the head does not*- 
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move. To read a certain place on the 
disk, the head moves to the correct 
[rack (radius), and waits for the data to 
spin under the head. 

It takes three miUiseconds to move 
the head one track. This is called step- 
ping the head, and is done by the stepper 
motor. When it gees to the destinadon 
track, it takes 30 milliseconds for the 
head to quit ratding enough to do 
something useful. This is known as 



head settling time- 
Each track is about 6,000 bytes 
"long!" 1 say long because, although they 
are on a circular surface, the tracks do 
have a beginning and an end marked by 
an index pulse. Every time the disk 
spins, the drive briefly recognizes one 
point on the disk which generates a 
pulse once per rotauon. (On 5 1/4'inch 
disks, a small hole toward the center of 
the disk is uncovered and a light gener- 



FDCPINOUTS 



FDC TO DRIVE: 

6: DRIVE SELECT D. (Not used on ST). 

10: DRIVE SELECT A-NOT. (+0 volts=turn drive & light on. Note this 
doesn't turn on the motor; see pin 16.) 

12: DRIVE SELECT B-NOT. (Not used on the ST). 

14: DRIVE SELECT C-NOT. (Not used on the ST). 

16: MOTORON-NOT. ( + volts^stort spinning the diskette). 

18: STEPDIRECTION. When you step the head, this line must tell the 
drive whether to step in or out. See wire 20. 

20: STEP-NOT. This line Is BRIEFLY brought to +0 volts to step the drive 
one trock in the direction STEP DIRECTION specifies [in or out). 

22: V^RITE- DATA- NOT. This Is actual bit stream headed for the disk track 
at around 100,000 baud. 

24: READ/WRITE-NOT. V^hen +5, the drive is reading. When +0, the 
drive is writing. 

32: SIDE SELECT-NOT. Puii to +0 volts to write to bock side of diskette. 

DRIVE TO FDC: 

8: INDEX PULSE-NOT. Goes to ground BRIEFLY each rotation, five 
times per second (300 RPM). Otherwise +5. 

26: TRACK 0~NOT. +5 unless drive is at track 0, when this pin goes to 
+ Q volts. This is how the drive tells the FDC to quit stepping it to- 
wards track 0. 

28: WRITE PROTECT-NOT. +0 volts if the write protect tab is set on the 
diskette; +5 volts if it is okay to write to the diskette. Note: the drive 
mechanism will prevent writing if this Is set even if the FDC tries. 

30: READ-DATA-NOT: The actual real live bitstreom from the diskette, at 
100,000 baud, complete with wow and flutter [the factory options). 



ates the signal. This same thing is ac- 
complished mechanically on 3 1/2- 
inch disks by a rectangular hole in the 
metal hub of the disk.) The disk rotates 
at 300 RPM (plus or minus one per- 
cent), hence there are five index pulses 
per second, each of which marks the 
beginning and end of a track. 

Typically, the track is divided into 
.sectors, which are logical-sized chunks 
of track. This way you can work with 
one chunk (sector) of the track instead 
of modifying the whole thing at once. 
The Atari ST has nine 512-byte sectors 
per track, numbered one through nine. 
Remember, tracks are numbered starting 
at zero; sectors begin at one. 

On most computers, a chip called a 
Floppy Disk Controller (FDC), which sits 
between the Central Processing Unit 
and the floppy disk, governs the floppy 
drive. Think of the FDC as a slow, 
sophisticated, slow, helpful, slow, and 
advanced slow chip. If you are program- 
ming the FDC, always bear in mind the 
slow part and you'll save yourself a great 
deal of trouble, 

THE CONNECTIONS 

"lb understand the FDC, you must 
understand exactly what it does to the 
disk drive. The FDC Track 00 bit, for 
example, is not going to make much 
sense unless you've read about the 
Track 00 detect wire. Since you're using 
the FDC to talk to hardware, it helps to 
know the hardware. 

The FDC chip used by Atari is the 
Western Digital 1772, The 1772 is con- 
nected to the floppy disk drive with a 
H-pin cable. This 14-pin cable expands 
to a 34-pin ribbon cable inside the 
drive case. The 34-pin connector has 
long been an industry standard in 
5 '/4-inch disk drives. Even IBM uses 
something very close to it, differing only 
in two wires. Hence, the signals are 
pretty well standardized. (This is why 
you can hook a 5W-inch drive to the 
Atari ST See my article in Antic's ST Re- 
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source, Nov. '8:?, tided 'ST Uses IBM 
Disk Files") Typically the 34 pins are 
brought out in a ribbon cable, then to 
an edge connector 

Fortunately, we don't have 34 sepa- 
rate signals to worry about. Every other 
wire is either Ground or +0 volts, 
which helps suppress some of the radio 
noise the cable puts out. There are only 
17 active wires, and the wires are in 
two groups: FDC talking to disk, or disk 
calking to FDC. No single wire is bi- 
direchonal (see Figure 1). 

The voltages on the wires are always 
either +5 volts (logic one) or +0 volts 
(logic zero). Generally, when there is 
some sort of logical iunction, the vol- 
tages work the opposite of what you 
would expect: 4-5 volts means "don't do 
anything;" +0 volts means "begin," The 
reasons for this are lost in antiquity 

When you see a wire labelled 
XXX-NOT, it means that when the wire 
hiLs +0 volts (NOT), something hap- 
pens. This is as opposed to doing some- 
thing at + 5 volts, which is more stan- 
dard inside computers. Example: When 
the MOTORON-NOT Ime is at +5 volts, 
nothing happens, but when it is at -l-O 
volts, the motor spins. 

SECTOR THEORY 

Having discussed diskette theoiy and 
the basic electrical connections, let's talk 
about sector theory. 

The FDC must handle the extremely 
fast data streams to and from the dis- 
kette. Once the disk is formatted-all in 
one long write operation-any disk 1/0 
is done at the sector level in short 
bursts. If you are to become an FDC 
Wizard (and you will), it will be your 
job to properly program the FDC so it 
can handle those bursts. 

Sectors are read or written, one sector 
at a time, in discrete chunks. In other 
words, there is no way to read or write 
only one part of a sector. The sector is 
the smallest "addressable" chunk on a 
disk. 



Why Dl2 bytes per sector (BPS)? 
Other convenient sizes are 128 BPS (as 
in the Atari 810 and 1050), 256 BPS (as 
in many aftermarket 8-bit drives), and 
1024 BPS. Atari seeded on 512 for the 
ST because IBM did it that way, and 
Atari wanted the ST drives to be disk 
compatible with the new IBM laptops. 
(And they are.) 

When the diskette hrst comes from 
the factor)', it contains nothing but ran- 
dom magnetic noise To use it, you must 
hrst lay down some marks that are 



never changed. These mark the begin- 
ning and end of each 512-byte sector, 
and are called address marks. This hap- 
pens each time you format a disk. 
Think of it as drawing ruler lines on a 
blank piece of paper 

Address marks consist primarily of 
sector headers, which are followed by 
data fields. There is one sector header 
and one data field per sector, and nine 
of them per track, numbered one 
through nine. Every sector has a six- 
byte header which identifies the sector^ 





TRACK LAYOUT 








Index Pulse 








(beginning of the track) 


number of 


data 




bytes 


(hex) 






80 


4E 


Data separator synchronization only 


Appears 


12 


00 


Data separator sync alas 


once per track 


03 


F6 


"FDC, lock up with me to start." 


for indexing. 


01 


FC 


Index Mark 




^50 


4E 


More data separator sync bytes 




12 


00 


Help the data separator , . . 




03 


F5 


More sync . . . 




01 


FE 


"1 AM A SECTOR HEADER" 




01 


Track* 


The track this had better be 




01 


Side* 


Thesidenumberth[sis(Oor 1) 


Repeated 


01 


Sector* 


The sector number 


nine times 


01 


02 


Sector size: 02 = 512. (00=128, 


per track 






01=256,02=512,03=1024) 


producing 


02 


CRC 


The Sector Header CRC 


nine sectors. 


22 


4E 


Resync Data Separator 




12 


00 


Resync Data Separotor 




03 


F5 


Resync Data Separator 




01 


FB 


"1 AM THE SECTOR'S DATA FIELD" 




512 


Data 


The actual data bytes [gee whizi) 




02 


CRC 


The CRC of the data 




54 


4E 


Resync Data Separator 


Note that the last 54 


4E's become the first 4E's of the next sector, immediately 


preceding the twelve 


OO's. 
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number tontr ihrough nine) that will 
immediately follow it. The lirst four 
bytes of the header are: 

Western 

Digital NEC 

Byte Name (ST) Name (IBM) 

1 Track Cylinder 
number number 

2 Side Head 
number number 

3 Sector Record 
number number 

4 Sector Number 

Size 

As the above table demonstrates, 
manufacturer terminology is often in- 
consistent. You'll find "Sector not 
found" errors and "Record not found" 
errors. No matter, they're the same 
thing- 

The last two bytes of the sector 
header are known as a CRC (Cyclic 
Redundancy Check)- There are actually 
two CRCs per sector This first one-the 
header CRC- is a special summation of 



the previous four bytes of the header. 
The header CRC is calculated only once, 
at format nme, and written to the disk. 
Anytime the header is reread, the CRC 
is checked by the FDC on the fly and 
compared to what is on the disk header 
Any difference means that data on the 
disk changed without the FDCs help. 
This translates into a disk en-or 

After the sector header are 512 bytes 
of data (the data field) followed by a 
second CRC that checks the preceding 
512 bytes of data field. The data CRC is 
recalculated and rewritten everytime the 
FDC writes the sector data. 

Although the data field is rewritten 
many dmes, the sector header is only 
written once at formatting time. The 
F-DC handles the timing of these oper- 
ations. 

THE GUTS OF A TRACK 

What does a track look like at the byte 
level? A quick way to find out is dump 
the entire track to memoiy, using the 
FDC Read Track command, Alas, there's 




HARD DISK DMA PORT 



FLOPPY DISK PORT 



a catch. Some of the bytes written to a 
track at format time can never be reread 
because they are intercepted by the data 
separator and never seen by the FDC. 

Check out Figure 2 for the layout of a 
track. At the end of the track, there is 
actually room for one more 512-byte 
sector, which would give you 80 tracks 
times 512 bytes, or 40K more storage 
per disk side. The ST can access this 
"extra sector" but since the name of the 
game is IBM compatibility, nine sectors 
per track is standard. 

So, if we dump a track using the 
FDCs Read Track command, we will 
not see the clean, well-mannered listing 
in Figure 2 because those $4E's will be 
in use by the data separator as it 
quickly tries to stay in step with the 
disk. Data won't wait. As the data sepa- 
rator drifts, you will get trash (weird- 
looking bytes) in the Read Track data. 
Commonly, the data separator will ac- 
cidentally lock onto the data bits in- 
stead of the clock bits, and the FDC wilt 
see lots of $FF's. That's okay, by the end 
of the $4E field, the data separator 
should have adjusted itsell back into 
sync. But be forevi^med: the data will 
not appear cleanly and will vary even 
from read to read. 

The bytes in Figure 2 that begin with 
"F" do not appear on disk the way they 
appear in the figure because, when for- 
matting the track, the FDC translates 
these bytes into missing clock pulses 
that tell the FDC this byte has a special 
function -be it a sector header, start of 
data mark, index mark, CRC, or what- 
ever You won't see these on a track 
dump because the FDC will be busy. 

OPERATING THE FDC 

Programming the FDC mvoK'cs setting 
up the TRACK, DATA, and SECTOR 
registers of the FDC, then writing to the 
COMMAND register Just doing the 
write will cause the command to exe- 
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cute. You then wait for the FDC to tell 
you it is finished by watching the IRQ 
(Interrupt ReQuest) line via the MFF 
(MuitiFunction Peripheral controller) 
chip, bit five. 

Some miscellaneous considerations: 
You must select the disk-drive number 
and disk side (done with the Yamaha 
sound chip, port A, lowest three bits), 
and you must deal with the DMA con- 
troller But basically, it's a matter of get- 
ting the drive online, then writing to the 
COMMAND register of the FDC to get it 
to do something. 

The TRACK register is used a great 
deal (Step commands and Sector com- 
mands), the SECTOR register is only 
used for sector I/O, and the DATA regis- 
ter is only used for Step commands be- 
cause, during sector 1/0, the DMA chip 
handles the data transfer 

THE DREADED 
MOTORON KLUDGE 

Look again at the pinout listing in Figure 
I, and you will see that one of the wires 
going from the FDC to the disk drive is 
MOTORON-NOT When this line is 
brought to zero, the motor spins. 

There are several subUe considera- 
tions here: 

1. MOTORON is separate and distinct 
from DRIVE SELECT You can select 
a drive, have its light on, and not 
have it spinning; or you can have it 
spinning but not selected. Just be- 
cause they have always worked to- 
gether doesn't mean they have to. 

2. You must give the motor time to 
bring the drive up to speed before 
you do any reading or writing. The 
data separator is painstakingly tuned 
to data coming in at 300 RPM. Vary 
that, and the separation will fall 
apart. Generally, you need at least 
1/5 of a second to get the motor up 
to speed. 

3. You need to shut the motor off when 



you're done so the drive isn't spin- 
ning all the time. Otherwise, the 
head will Hterally wear a groove 
through your diskette. On the other 
hand, if you have a string of 
read/write operations, you don't 
want to shut the motor off after each 
one or you'll have to wait for the mo- 
tor to get back up to speed before 
doing any new operation. 
Normally, Western Digital chips re- 
quire external hardware to accomplish 
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the above feats. To process a command, 
you switch on the drive motor and wait 
for it to get up to speed. When done, 
the hardware keeps the drive spinning 
another couple of seconds, then reluc- 
tandy shuts it off. 

Western Digital, in their infinite wis- 
dom, gfive us some hardware inside the 
1772 that helps with this task. If you set 
the Motor-On flag (see FDC COM- 
MANDS, below), the FDC will turn on 
the drive, then wait for several index 
pulses before continuing; since each 
pulse takes at least 200 milliseconds, 
the drive ought to be up to speed. 
When the command is done, if ten in- 
dex pulses go by, the FDC shuts off the 
motor 

The problem is this: You must have 
a 'iekclcd di5l< out there before the FDC 



can see index pulses. Therefore, you 
must leave the drive selected after com- 
plering a command or the FDC won't be 
able to shut off the motor But after the 
motor shuts off, courtesy of the FDC, 
the drive still stays on. And that's bad 
news. 

Atari solved this dilemma by looking 
at the drive each vertical blank (VBL), 
which is 50 times per second in color 
and 70 times per second in mono- 
chrome. If the FDC has just shut the 
motor off, the VBL task shuts off the 
DRIVE SELECT, turning off both the 
drive and its light. 

Ah, but to sample the FDC, the VBL 
task has to talk to the FDC, which in- 
volves talking to the DMA chip first. All 
this boils down to big trouble if you're 
in the process of talking to the disk. So 
Atari set up a flag, called "flock," which 
may be found at $43E in scenic TOS, 
Flock must be set anytime you're going 
to use the FDC. It tells the VBL task- 
which will certainly interrupt your pro- 
gram a lot- not to touch the FDC for a 
while. After you are done with the FDC, 
turn flock off, and the VBL will shut off 
your disk drive for you. 

If you forget about flock, you're 
doomed in two ways; The FDC will be 
stolen from you periodically, or the 
drive will forget to shut off. Neither al- 
ternative is good. 

FDC COMMANDS 

Lets go through the commands that you 
can issue to the FDC, For extensive 
electronic specifications, I recommend 
picking up the Western Digital 1772 
product sheet which can be obtained 
through most electronic parts suppliers. 
The FDC has four registers. Registers 
are a bit like memory. You can write a 
byte into them, or read a byte out of 
them. Of course, trying to figure this out 
from the product data sheet is nearly 
impossible because they write the sheets 
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COMMAND SUMMARY 











BITS 






TYPE COMMAND 


7 


6 


5 


4 


3 


2 


1 


1 Restore 














h 


V 


n to 


1 Seek 











1 


h 


V 


ti r„ 


1 Step 








1 


u 


h 


V 


ri To 


1 Step-in 





1 





u 


h 


V 


ri r„ 


1 Step-out 





1 


1 


u 


h 


V 


r to 


II Read Sector 










m 


h 


E 





II Write Sector 







1 


m 


h 


E 


P a„ 


III Reod Address 




1 








h 


E 





III Read Track 




1 


1 





h 


E 





III Write Track 




1 


1 


1 


h 


E 


P 


IV Force Interrupt 




1 





1 


U 


I2 


li lo 


FLAG SUMMARY 
















TYPE 1 COMMANDS 






Oo = 


Data Address Mark (Bit 0) 


h . Motor On Flag (Bit 31 




ao = 


0, Write Norm 


al Data Mo 


rk 














h . 0, EnobieSpin-UpSeque 






E = 


15ms Settling Delay (Bit 2) 


V = Verify Flog (Bit 2) 






E = 

E . 

P - 


0, No Delay 

1, Add 15m. Delay 

Write Precompensat 




V = 0, No Verify 

V =^1, Verify on Destination Track 




on (Bit 1) 


ru To = Stopping Rote (Bits 1,0) 




P - 
P = 


0, Enable Write Precomp 

1, Disable Write Precomp 




r, r, WD1772-02 




TYPE iV COMMANDS 




6 

1 12 


ms 







1 3n 

Updare Flag (Bit 4) 



u = 0, No Update 

u = 1, Update Track Register 

TYPE II & III COMMANDS 

m = Multiple Sector Flag (Bit 4) 

m = 0, Single Sector 

m = 1, Multiple Sector 

h = Motor On Flog (Bft 3} 

h ~ 0, Enoble Spin-Up Sequence 

h = 1, Disable Spin-Up Sequence 
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}-lo Interrupt Condition (Bits 3-0) 

, = 1, Not Used 
= 1, Not Used 
, = 1, Interrupt on Index Pulse 
I = 1, Immediate Interrupt 
i-Iq = 0, Terminate without interrupt 




primarily for FC designers. So when 
they say "CS-NOT=0, Al = l. A0=1. 
DATA register selected^' they are really 
saying that i[you read address xxx, 
you'll get what is in the DATA register 
The registers look like this. 



STATUS COMMAND 

1 TRACK TRACK 

2 SECTOR SECTOR 

3 DATA I^ATA 

1 lence if you read Register 0, you will 
get the current FDC status. If you write 
Register 0, you will issue the FDC a 
command. Registers 1 or 2 are always 
used to set a track or sector number 
Register 3 is used to read or write a byte 
of data from the controller 

Now, if we were on a normal com- 
puter system, there would be four ad- 
dresses we could directly PEEK or 
POKE to twiddle the floppy controller 
chip. We are not. Atari in its wisdom set 
the DMA chip right smack between us 
and the FDC (see Figure 3). So, not only 
do we have the exciting thrill of hassling 
with the FDC, we also have to beg the 
DMA chip to let us talk to the FDC. 
We'll solve that in a bit. Take a look at 
Figure 4. 

There are four flavors of FDC 
commands: 

Type I commands are essentially 
"move the head;' You will be surprised 
at the variety of ways Western Digital 
found to move it. 

Type U commands are Read/Write sec- 
tor commands. There are only two, 
praise be. 

Type Ul commands deal with the disk 
at the track level. They are for reading a 
track, reading the ID marks, or format- 
ting a track. 

Type !V commands are Force Inter- 
rupts. These are only used when the 
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FDC has gone to sleep and cannot be 
awakened. However, do not rely on 
them too much; there are ways to put 
the FDC to sleep that are permanent 
until poweroff, and one of the easiest is 
an improper Force Interrupt. Generally 
a Force Interrupt is handy during a fro- 
zen Read/Write command. 

Taking the command types one at a 
rime, I will show the bit pattern for the 
command, and talk about what the bits 
do 

TYPE I COMMANDS: 



Command 


Bit Pattern (7-0) 


Restore: 




0000 h V r, r„ 


Seek: 




0001 h V r, r„ 


Step: 




OOlu h V r, rj 


Step In: 




OlOu h V r, r„ 


Step Out 




01 lu h V r, r„ 



Restore moves the head to track 0. 
Seek moves to a given track number. 
Step In and Step Out step the head once 
in the direction indicated, and Step 
steps the head one track in the direc- 
tion previously established by Step In or 
Step Out. The individual bits are as fol- 
lows. The function is performed if the 
bit is ON: 

u: Update the Track Register Reflects 
the current track. This means you will 
be able to read the Track register from 
the CPU to hnd out what track the FDC 
is on. 

h: Motor-On Flag. This means that 
before anything happens, the FDC will 
turn on the drive's motor and wait six 
revolutions of the diskette to let the dis- 
kette get up to 300 RPM before anything 
happens. You will also find h on other 
commands. It saves the programmer the 
agony of wondering if the disk is up to 
speed, 

V: Verify Track. When the step is 
completed, the FDC will read a sector 
mark from the disk and compare the 
track number written on the disk with 



what it thinks the track number should 
be. If they dont match, either the disk is 
weird or the FDC is out of whack with 
the disk. Caution: a strange disk (such 
as a copy protected disk) will often have 
weird track numbers deliberately writ- 
ten into the sector marks. And a disk 
that is blank will have no track num- 
bers at all, 

Ti, Tf,: Step Rate, The floppy-disk 
drive head can only move at a certain 
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wait about 32 
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doing a 

Force interrupt while 
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drunkenly 

awalce. 



speed between tracks; r,, r^ selects this 
speed. It works like this: 

00: 6 msec per track (use this for 5 
1/4-inch disks) 

01: 12 msec (no need) 

10: 2 msec (kind of fun for 3 1/2- 
inch, but not reliable) 

11: 3 msec (the usual for 3 1/2- 
inch, unreliable for 5 1/4-inch) 

The specifications given in the De- 
veloper's Toolkit from Atari are just 
plain wrong about these step rates. Use 
the above figures. Generally, stick with 
11 for 3 1/2-inch drives and 00 for 5 
1/4-inch drives. 



Typically, you don't ever use the Step. 
Step In, or Step Out commands. Use 
Seek and maybe Restore, 

Seek works like this; The FDC thinks 
it is on track #(TRACK register). It may 
be wrong because of switched drives or 
other confusing phenomena. If it is 
wrong, best correct its thinking by 
stuffing a number into that register be- 
fore the Seek, Then, put into the DATA 
register (#3) the number of the track to 
which you want to go. Then, issue the 
Seek command and wait around until 
the Busy bit of the STATUS register goes 
away The FDC is done. 

Restore is another handy command 
It cares little about where the head is, 
but pulls the head in until the Track 
zero line goes low. Restore is helpful af- 
ter a read/write error because if there's 
dust on the head tt cleans the dust off 
by moving the head a long way across 
the disk. Also, if the disk head has wob- 
bled, Restore gets the FDCs TRACK reg- 
ister and the actual head back together 

Something Western Digital didn't 
think of: There are two drives and one 
TRACK register The drives are usually 
on different tracks. Hence, anytime you 
switch drives, you must store the cur- 
rent track for this drive somewhere, 
fetch the current track for the new drive 
from somewhere efse, and put it into 
TRACK, Otherwise, the FDC will get out 
of sync with the new disk. Atari BIOS 
routines handle this by reserving some 
locations for the stored track number 
Look at $A08 and $AOC on ROM-based 
ST systems, 

TYPE II COMMANDS 

Fortunately, tliere are only two com- 
mands to won)' about here. They are 
Read and Write Sector They look like 
this: 

Command Byte# (7-0) 

Read Sector: 100m h E 

Write Sector: 101m hEPa,, ► 
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Our old friend h is still here. Use 
him if you're nor sure if the drive is up 
to speed, which is almost always. The 
new bits are: 

m: Multiple Sectors, Usually you 
don't do this. If 1, the FDC will read or 
write sectors starting at the sector num- 
ber you give it until you Force Interrupt 
the controller out. This is really a mar- 
velous way to hang the controller If you 
are very, very good, you can use this to 
read an entire track in one rotation of 
the diskette, like Atari^s people did. but 
beware, 

E: SerdingTimc (30 milliseconds). 
Assuming you just stepped the head, 
Setting this bit tells the FDC to wait 30 
milliseconds to give the head time to 
stop ratding-a good idea, (You also can 
do this during the Step by turning on 
the verify bit, but that has, other 
problems,) 

FIGURES 



P: Enable Write Prccompensation. 1 
was hoping not to get into this, but, , , 

When you write all those magnetic 
fields onto a disk, you get the same 
effect as if you had made a line of bar 
magnets. North and south poles of two 
magnets attract, and north and north 
poles of two magnets repel This causes 
your bits to literally wander on the dis- 
kette. At read dme they can get so far 
away from where they should be that 
the data separator cannot follow them. 

So, we have "Write Precompensation 
that writes two north-north magnets 
slightly closer together and two north- 
south magnets slighdy farther apart. 
This way bits repel, attract, and end up 
at roughly the correct position. Write 
Precompensation is not really necessary 
for single density, but you will want it in 
a big way for the double density used 
by the ST. So keep this bit on when 



wrinng 

ag-. Data Address Mark. Remember 
our Beginning of Data Field mark ($FB) 
which appears at the beginning of each 
sector's data? (see Figure 2). You have 
the opdon of using $FB (which you 
should do), or writing a deleted data 
mark, which just offers a fairly dumb 
way to mark, at operating system level, 
whether or not a sector is part of an 
erased file. If you set this bit, you will 
write an $F8 instead of an $FB, and ev- 
ery time you read the sector, a status bit 
will be set telling you this is a "deleted" 
sector This causes problems. Summaiy: 
Don't. 

To read or write a sector, first set the 
SECTOR register and TRACK register so 
that they will match the sector and 
track data found in the sector header 
(Otherwise, the FDC will insist "Record 
Not Found"; it checks both,) Next, issue 



STATUS REGISTER DESCRIPTION 


BIT NAME 


MEANING 


S7 MOTOR ON 


This bit reflects the status of the Motor-On output. 


S6 WRITE PROTECT 


On Read Record: Not Used. On Read Track: Not Used. On any Write: It indicates o Write 
Protect. This bit is reset when updated. 


55 RECORD 
TYPE/SPIN-UP 


When set, this bit indicates that the Motor Spin-Up sequence has completed (5 revolutions) 
on Type 1 commands. Type II & III commands, this bit indicotes record Type. = Data 
Mark. 1 = Deleted Data Mark. 


S4 RECORD NOT 
FOUND (RNF) 


When set, it indicates that the desired track, sector, or side was not found. This bit is reset 
when updated. 


S3 CRC ERROR 


If S4 is set, on error is found in one or more ID fields; otherwise it indicates error data 
field. This bit Is reset when updated. 


S2 LOST DATA/ 
BYTE 


When set. It indicates the computer did not respond to DRQ in one byte time. This bit is 
reset to zero when updated. On Type 1 commands, this bit reflects the status of the TROO 
signol. 


SI DATA REQUEST 
INDEX 


This bit is a copy of the DRQ output. When set, it indicates the DR is full on a Read Opera- 
tion or the DR is empty on a Write operation. This bit Is reset to zero when updated. On 
Type 1 commands, this bit indicates the status of the IP signal. 


SO BUSY 


When set, command is under execution. When reset, no command is under execution. 
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the Read command, and watch che 
iireworks. 

There are some kludges to go 
through CO set up the DMA chip that 1 
will discuss later. 

TYPE III COMMANDS 

These are U"ack-level commands. One of 
them. Write Track-also known as for- 
matting the track-is used all the time. 
Do [his 80 times with a Step in be- 
tween, and you've formatted the disk! 

The Read Address command reads 
the next address mark on a track and 
returns it to you. This is a great way for 
findmg out exactly what is on a track, 
particulady if the track is damaged. If 
you repeat this command over and over, 
you'll get a list of all living sectors on the 
crack. Usually this is nine sectors times 
six bytes, or 54 bytes. 

Read Track gives you a fairly accurate 
dump of the entire track, all 6.000-odd 
bytes, so have a big memory area wait- 
ing to receive data. It generally manages 
to foul up anytime the data separator 
resyncs at the beginning of each sector, 
and sometimes drops a byte out of the 
blue. It is a handy tool for examining a 
track that has utteriy died- but is not 
reliable enough for day-to-day use. 

Write Track, as mentioned, formats 
the track. Again, it takes around 6,000 
bytes to do this. One way is to set up a 
memory table 6,000 bytes long and feed 
it CO the FDC as each byte is requested. 
Atari does it this way Another method 
is to sec up a bunch of nested loops and 
do it in code (note how many repeated 
bytes there are in Figure 2), This is fine, 
but your code has to be darned fast to 
work, because the FDC will ask for a 
b\'te once every 32 microseconds. Even 
the 68000 doesn't need any distractions 
when trying to transfer data at that 
speed, so shut off intermpts while you 
are doing direct disk I/O. By the way 
the DMA controller handles I/O on the 



ST. and is immune from interrupts. 

During formatting, the Floppy Disk 
Controller cakes special accion on any 
SFx byte and writes special marks to 
the disk. For instance, when you feed 
chc FDC an SFB, ic wrices an $FB wich a 
clock byte of SC7 instead of $FF It also 
starts the CRC calculator running. (SFB 
is the beginning-of-data mark, remem- 
ber.) An $F7 input byte results in the 
FDC writing two CRC bytes wich no 



+ 5 volts means 

"don't do anything;" 

+0 volts means 

"begin." 

The reasons for 

this are lost in 

antiquity. 



$F7 in them at all. Hence, remember 
this rule: Any byte input to che FDC 
during Write Track (fonnac) chat begins 
with an $F is going to do someching 
weird. 

This is why you can't do a Read 
Track, then a Write Track with the same 
data CO clone a crack. First, Read Track 
will not always give you the right sector 
data, and it will definitely screw up the 
beginnings of sectors. Second, Write 
Track does funny things with SFx bytes, 
including bytes you find in the middle 
of a sector; you cannot format data into 
a sector with SFx's in it, Inscead, format 
a blank crack, chen copy the data. If 
you're fast on your feet, you can issue 
nine Read Sector commands in one 
track re\'olution, then nme Write Sector 



commands in one revolution. Or, il 
you're brave, you can use the Multiple 
Sector Read/Write 

Follow the formatting command 
with a Read Sector for all the sectors on 
the track to see if there are any bad 
spots on the disk. A CRC error means a 
bad spot. 

According to the Atari BIOS manual, 
formatting the data fields with zeroes is 
bad karma to the operating system. Be- 
sides, it doesn't test the disk very well. 
Use a repetition of S6DB6 instead. This 
places maximum stress on the north- 
north and north-south magnetic field 
patterns. The operating system will take 
care of inidalizing the sectors for boot, 
directory, and so forth after formatting. 
Read a freshly- formacced IBM disk sec- 
tor and you will find $6DB6 

TYPE IV COMMANDS 

There is really only one Type IV com- 
mand: Force Interrupt, Western Digital 
gives you a bunch of options on how to 
interrupt the controller (immediately, af- 
ter index pulse, by next Christmas. . .), 
Most of these are completely unused. 
The thing to do is: 

Force Interrupt Right Now: 1101 1000, 
then, 1101 0000. This usually wakes the 
controller up. (The $D8 is an Immedi- 
ate Interrupt and the SDO is a Clear The 
Immediate Interrupt.) 

You must wait about 32 microse- 
conds after doing a Force Interrupt 
while the FDC wobbles drunkenly 
awake Do anything faster and you will 
shut down the interrupt and really eu- 
thanize the FDC- 

Do the Force Interrupt whenever 
anything fails in a floppy disk 
read/write. Atari does it all the time. It's 
the "resetl770" subroutine. 

STATUS REGISTER 

The STATUS register (see Fij^ure 5) gives 
you eight bits of wildly exciting infor- ^ 
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PROBING.. 

mation about the last command you 
did. Generally, it reflects information 
about stepping commands. But you 
never can tell. If you need to get the sta- 
tus, do a Seek from the current track to 
[he current crack. This is a no-operation 
command, but it sets the STATUS bits 
correctly Atari does this in their BIOS to 
leave the FDC in a knov^n, Type 1 status 
state. 

You can read STATUS after a sector 
read/write to look for deleted data 
marks, CRC errors, and so forth. But 
wait 32 microseconds after the Busy bit 
goes away before looking at STATUS, 
Otherwise, the FDC may not have yet 
updated the STATUS byte. 

The bits look like this; 

S7 Motor On 

If I, the MOTORON output to 
the drive is on. If zero, it is not. 

S6 Write Protect , 

On a Write operation, 1 indi- 
cates chat Write Protect is ac- 
tive and you can't write to the 
drive. 

55 Record-type/Spin-up 
Type I command: 1 = 
MOTORON spinup complete. 
Type II, III command: 1 = You 
just read a deleted data mark. 
Why? 

S4 Record Not Found error 

1 = You tried to read a sector 
that was not there. The FDC 
^ve up after 5 revolutions (1 
second). If you think the FDC 
is lying, best check the TRACK 
and SECTOR registers. 

S3 CRC error 

A 1 usually means you had a 
bad data-CRC in the data area; 
the disk has problems. How- 
ever, if the RNF bit (above) is 
also set, you have a bad CRC 
in the sector header, which is 
usually gruesome co fix. Note 
that you can often repair a bad 



data CRC by rewriting the sec- 
tor See above discussion, 
52 Lost Data/Track 00 

Type I command: I = You are 
on track 0. 

Type II, ill command: I = You 
did not get back to the FDC 
fast enough to read a byte it 
wanted to hand you, or you 
did not give a byte as fast as it 
wanted. This means your data 
I/O loop is too slow (1 warned 
you!), or it could mean you 
forgot to turn the interrupts ofl 
and the 68000 got distracted. 
Remember 32 microseconds 
per byte, and that means not 
very darn many 68000 in- 
structions, 

51 Data Request/Index Pulse 
"iype I command: This reilects 
the index-pulse pin. If you 
read this in a tight loop, it will 
usually be 1, but eveiy 1/5 of a 
second it will briefly go to zero. 
Type II, III command: 1= The 
FDC either wants a data byte 
\ight now or it wants you to 
read one right now. If you're do- 
ing "palled 1/0," you sit and 
watch this bit, and whenever it 
goes high, you read or write a 
byte. 

50 Busy 

1= A command is undei"svay. 
Don't joggle my elbow. Note 
that this does not set for 32 
microseconds following input 
of a command, so you had bet- 
ter wait awhile after issuing a 
command before testing Busy, 
or it will not reflect Reality 

Generally, you will do a sector 
read/write, read in STATUS, and mask 
off the bits chat are useless (everything 
except Lost Data, CRC, Write Protect, or 
RNF error), then look for any nonzero 
value equaling disaster 



CORRECTIVE ACTION 
WHEN READ/WRITE 
BOMBS 

If the read/write bombs, first retry the 
command up to four times. (CP/M sys- 
tems retry ten times, which oughc co cell 
you something.) It may work on retry 
because of dust on the head rubbing 
ofT, phase of the moon, electrical tran- 
sients, witchcraft, or thin spots in the 
disk oxide. 

If that doesn't work, restore the head 
back to Track zero, then move it back to 
the track you were working on and try 
a^in. This resetdes the head on the 
correct track in case it drifced, and rubs 
goo ofT the head. Try this whole proce- 
dure twice; it often works. Recries are a 
fact of life even with diskettes in perfect 
conditions. Build them into your code 
and count on them, 

THE DMA CONTROLLER 

We have mentioned that Atari placed a 
DMA chip between memory and both 
the hard disk and floppy disk con- 
troller The DMA chip can kick the 
68000 oR" of memory long enough to do 
data transfers, and it is essential for the 
speed required when using a hard disk 
(see Figure 3). 

Learn co live wich che DMA chip if 
you want co program the FDC You can 
only access the FDC through the DMA 
chip, and che DMA chip also handles 
data I/O to the FDC, 

To program the DMA chip: 
L Clear the FIFO (First In, First Out), a 
32-byte bufier or "holding pond," in 
the DMA chip which is used to in- 
hale chunks of data at a time. It must 
be cleared before new data goes in. 
(This 32-byte buffer can play hell 
with the ID-Mark Read command, 
which only transfers six bytes. They 
will not make it to memory. After an 
ID-Mark Read, read in three or more 
ID Marks to force the data through 
the buffer) 
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2. Tell the DMA chip you're going to be 
reading or writing by how you do 
step #1: For Read use $90,$19aS90, 
and for Write use $190,S90,$190. 

3. Tell the DMA chip how many 512- 
byte chunks you're going to transfer 
(This will be sectors in the case of 
Read/Write Sector, but also applies 
[0 track reads of 6,000 bytes.) 

4. Ask the DMA chip to let you talk to 
the FDC registers. 

5. Set the Floppy Drive Controller 
registers (TRACK and SECTOR) as 
necessar)', by first asking the DMA 
chip to let you talk to a specific reg- 
ister, and then sending data to that 
register 

6. Ask the DMA chip to let you talk to 
the FDC command registers. 

7. Issue the command to the FDC. 

8. Wait for the FDC to finish the com- 
mand by looking at its IRQ line 
which goes to zero when the FDC is 
done. Conveniently, you can sample 
IRQ with the MFP chip (bit 5). 

9. You're done. So poll the DMA chip to 
see what it thought of the transfer 
Was there a DMA error? No? Good. 
Bit of DMA STATUS should be 
nonzero. 

10. Ask the DMA chip if you can poll 
the FDC, Poll the FDC status register 
to see what the FDC thought. Was 
there an FDC error? No? Good. The 
various status bits should all be zero. 

You ask to talk to the FDC by putting 
a special number into the FIFO register 
of the DMA chip: 

$80: COMMAND/STATUS register 
$82: TRACK register 
$84: SECTOR register 
$86: DATA register 

Then, put the value you want sent to 
the FDC into the DISKCTL register of 
the DMA chip, and it'll make its u'ay to 
the FDC. 



The FDC is just not fast enough to 
keep up with the 68000 on anything, so 
you must surround all accesses to the 
FDC with delay loops. You will find 
these at the bottom of listing for the 
program, TRAKREAD, enclosed on your 
START disk. They can be most valuable. 

ATARI'S FDC BIOS 

Atari uTote a great deal o( soltware to 
mn the floppy disk. It is sent to all de- 
velopers as FLOPS in the BIOS listing. 
Because you must access the FDC 
through the DMA chip-which is an 
Atari-only part-an examination of this 



Atari in its 
wisdom set the DMA 

chip right smack 

between us and the 

FDC. 



software is essential. There ts litde or no 
documentation about the DMA chip. 
The only place you can look to learn is 
the floppy disk driver in the BIOS. 

The TRAKREAD program on your 
START disk uses Atari's own BIOS rou- 
tines. (Atari gave me permission to re- 
print them, thank heaven.) I weeded out 
things that were not essential for the 
task at hand (such as the Vertical Blank 
handler) and shortened, straightened, 
and commented the code lor your refer- 
ence. 

I use Atari's calling protocol for 
eveiything because, when you switch 
from this program to the real BIOS, 
eveiything will remain consistent. 

I've also modified Atari's Read-Sector 



routine to do Read-ID Mark and Read- 
Track, then called the Read-ID and 
Read-Track, The calling sequences tell 
all about the request, and can be 
modified if you should wish to. 

THE PROGRAM 

TRAKI^HAD is written with AS68, Atari's 
very own assembler. It should be com- 
patible with most in-line assemblers 
available with the various C packages. 
Using it is easy Double click on 
TRAKREAD.TOS, then insert the disk 
you wish examined. At the prompts, 
choose drive A or B; side Front or Back 
(use Front on single-sided drives); enter 
the Track number in hex (from $00 to 
S4F), and the disk will be read. The 
next prompt will ask you where to 
dump the information (C for console, P 
lor printer). During the dump, you may 
press any key to pause; press Control-C 
to exit to the Desktop. 

TRAKREAD does some obvious 
things, such as using Read-ID and Read- 
Track commands to scan the ID address 
marks and data on the track. But it also 
does a host of less visible things, such 
as stepping the disk. Take the program 
apart and examine it closely. It is 
provided primarily as a concrete exam- 
ple for all the theory we've been dis- 
cussing. We've covered a great deal of 
material in this article, I don't know 
about you, but I'm happy to bring it to a 
close. ■ 
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NEW for the ST . . . fromMUhTron 



CORNERMAN 



$49.95 



sr 



What Sidekick did for the IBM, Cornerman does better for 
your Atari ST! This utility gives you a host of useful 
desk-top tools in one simple, neat package. With every- 
thing from a built in clock to a full function calculator, a 
cluttered desk is a thing of the past. And as a Desktop 
Accessory, Cornerman is a available nearly anywhere 
within GEM. 

■ REAL-TIME CLOCK in digital or analog form. 

■ NOTEPAD lets you write and store notes for handy 
future reference and reminders. 

■ ASCII TABLE shows the ST's symbols with their 
decimal & hex values. Great for programmers! 

■ PHONE BOOK stores all your important names & 
numbers, dials through your modem and even records 
elapsed calling time! 

■ 16 DIGIT CALCULATOR: works in binary, octal, 
decimal, and hex; 3 memory registers; math and logic 
functions; base conversions; "tape" printer output. 

■ DOS WINDOW for easy access to MichTron's Dos 
Shell program. 

■ 15-SQUARES GAME simply for entertainment. 
, ■ Doesn't interfere with other programs. 



MICHTRON UTILITIES 



$59.95 



What would a utility be worth that could turn back time 
and end frustration? Before you find out the hard way that 
such a utility would be priceless, prepare yourself with 
MichTron UUUiies. This utility searches for and retrieves 
deleted files and lost data. Change file contents, attributes, 
file and volume names, or any individual bytes on disk! 
.lust type the new data or click on selector buttons. You 
can also format individual disk tracks and copy individual 
sectors to repair damaged disks. A new 10 sector format 
utility lets you add 80K of storage capacity to you disks. 



Personal Money Manager 



$49.95 



This personal accountant will keep accurate totals for as 
many expenses, income sources and accounts as you need. 
Print checks and other kinds of reports for a true picture of 
your current financial status. You can form projected bud- 
gets for future expenses and income. Fast and powerful, 
the Money Manager uses the GEM system for simplicity. 




VTILITIES 



THE ANIMATOR ($39.95) - Animate Neo or Degas 
pictures for business presentations, or just for fun. 

BBS ($49.95) - Complete Bulletin Board System 

BUSINESS TOOLS ($49.95) - Over 200 attorney- 
prepared business forms, letters, and contracts. 

CALENDAR ($29.95) - Desktop appointment calendar. 

D.F.T. ($49.95) - Transfer files between the ST and IBM. 

DOS SHELL ($39.95) - Mimics the MS-DOS command 
structure: "global" commands, batch files, and more. 

ECHO ($39.95) - Uses X-10 modules for a wireless 
remote-control system for home or office 

Introduction To LOGO ($49.95) - Easy tutorial lets you 
learn to program in Logo. 

KISSED ($39.95) - Debugger features full-screen editing, 
miniassembler/disassembler, help function and more. 

M-DISK ($39.95) - RAM-disk emulator gives you the 
equivalent power of an extra disk drive! 

MI-DVPE H ($39.95) - Fast, easy file duplication, 

MI-TERM ($49.95) - Advanced communication program 
lets your ST talk to virtually any other system. 

MIGHTY MAIL ($49.95) - Complete mailing-list mana- 
ger features multi-level sorts and conditional "flags" for 
specialized reports. 

SOFT-SPOOL ($49.95) - Frees your ST to print & 
compute at the same time. 

ARCADE GAMES: 

GOLD RUNNER ($39.95) - Infiltrate enemy gold mines. 

63 screens test your skill and logic (color monitor). 
MAJOR MOTION ($39.95) - Race down the highway, 

destroying enemy spies as you gain new weapons and 

defenses {color monitor). 
MISSION MOUSE ($39.95) - Avoid the prowling cats as 

you climb to the next goal (monochrome monitor). 
TIME BANDIT ($39.95) - Collect the Treasures of Time! 

Choo.se from a multitude of worlds: 13 unique arcade 

lands and 3 complete arcade/adventures (color monitor). 

STRATEGY GAMES : 

FLIP SIDE ($39.95) - Play Reversi against live or 

computer foes. 
CARDS ($39.95) - Blackjack, Cribbage, Klondike, Poker 

Squares, and Solitaire (medium or high res only). 




All reasonably priced, with more coming every day. Ask for our latest catalog.' 

Dealer inquiries welcome • Visa and Mastercard accepted • Add S3. 00 shipping and handling to each order. 



MichYron 



576 S. Teixgraph, Pontiac, MI 48053 
Orders and Information (313) 334-5700 

(IRCIE Oifl ON REftDERS SERVICE WRD 
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FUJIBOINK! 

BEHIND THE 
BIT PLANES 



FIND OUT HOW 



by Xanth Park 



In the beginning, there were 
bouncing balls. Lots of bouncing 
balls: Amigi, Atari 8-bit, and Atari 
ST. Then there was FujiBoinkl, which 
demonstrated the superiority of Atari 8- 
bit graphics. Now, PujiBoink! has been 
ported to the ST. This is the tale of [hat 
heroic leal. 

(.Editor's note: Amiga inUvduccd i(s 
graphia power wilh a dcmomtration 
featuring a mtating bouncing hall In 
November, 1986, Atari showed up at COM- 
DEX, in Las Vegas, demonstrating the same 
hoKiicifig ball on both the ST and the Atari 
8-bit machines. The 8-bit version was done 
l)y XANTH, a Seattle computer center. A 
Jew weeks later, at CES, XANTH was 
demonstrating a rotating, bouncingjuji (the 
Atari trademark symbol) with scrolling 
rainbow an the S-bit Atari's. Inevitably, this 
same demo was adapted, with startling re- 
sults, on the Atari ST.) 



mujiBoink!^ the bouncing rainbow fuji, is the best 
graphics demo START has seen on the Atari ST. We 
have received many requests from people wonting 
to know just how it was done. So, we went to the 
source: the programming wizards at XANTH. After 
a little arm twisting, they agreed to relinquish their 
secrets. All related programs, plus source code, 
may be found in the FUJI.STQ folder on your 
START disk. Please note: FujiBoink! requires a color 
monitor 



A while ago, a fellow and I were dis- 
cussing the Amigi and its bouncing ball. 
He said he was impressed by the large 
number oi rotation calculations that the 
Amiga was doing in real-time. 1 hated to 
disillusion him, but [ had to set him 
straight: The spinning is just an illusion. 
Now, 1 don't know what people think 
FujiBoink! is doing, but again, il's all a 
trick. If you're expecting some son ol 



miraculously fast 3D rotation and 
polygon-filling routines, do not read 
further-and give my re^rds to the 
Easter Bunny, 

But belore we ruin the illusion by ex- 
plaining how the magic works, those of 
you who have not seen FujiBoink! 
should read the sidebar and get the pro- 
gram up and running. ^ 
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FUJIBOINK!... 




FAR SIDE' BAR SIDE 

(ROTATED VIEW) 

FIGURE 1 

XANTH TELLS ALL 

The Effect: A red-and-white checker- 
board pattern is displayed. A trans- 
lucent title square fades in over the 
checkerboard. The Atari iuji symbol ap- 
pears, a rainbow of colors cascading 
down its face. It casts a transparent 
shadow on the background. The title 
square fades out. The fuji lalls and 
bounces and spins all over the screen at 
60 frames per second- 
How It's Done: FujiBoink! sets the 



screen to low-resolution and calls VDI 
to draw some red squares on a white 
background. It reads part of 
FUJIB01N.D8A (d-eight-a: data, get it?) 
and stuffs it into screen memory for the 
title screen, which is actually a portion 
of a NEO picture. The light pink 
squares of the title square create an illu- 
sion of translucency, which is height- 
ened by the fade-in and fade-out, ac- 
complished by adjusting the color 
registers. 



The rest of FUJIB01N-D8A is read in. 
Most of this data consists of 32 
predrawn views of the fuji in varying 
stages of rotadon, and the rest is shad- 
ing data for the side of the fuji. Succes- 
sive views are moved Into screen mem- 
ory at the appropriate place and time, 
thus creaung the illusion of rotation and 
movement. The transparent shadow is 
the result of careful manipulation of bit- 
planes and color registers. The rainbow 
is generated by a raster- interrupt 
routine. 

GENERATING THE FUJI 
VIEWS 

Well, die secret is out: FujiBoink! is just 
a glorified cartoon. Does this mean 
you'll stop reading? 

Thought not. 1 will now attempt to 
explain how the 32 views of the fuji are 
generated by the FUJIDRAW program. 

The fuji symbol has three basic 
parts, which I call the left tJiingy, the light 
thing/, and the middle tliingy (see Figinr 
la). At any value of Y, the fuji's cross- 
section can be described by the middle 
thingy's width, W; the fuji's thickness, 
D; and S and T, which define the con- 
tours of the left and right thingies (see 
Figure lb). The values for S and T were 
chosen manually, although a mathemat- 
ical description is certainly conceivable. 

To create the data file, a rotation 
operation is perfontied on each point of 
the cross-section and the face, farside, 
barside and nearside are plotted on the 
screen (see Figure Ic). Then, for the 
shadow, each thingy-section is 
projected mathematically against a 
backdrop, assuming a light source 11.25 
degrees to the side and 10 degrees 
above the horizon. 

This basic process is repeated for ev- 
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er)' value of Y and ever)' rotation. Each 
view, as it is completed, is written out to 
disk. Actually, only bit- planes 1 to 3 are 
saved, for reasons soon to be revealed, 
One other point: Each view is offset 
horizontally from the preceding view so 
that no run-time shifting is required to 
move the fuji horizontally. As you can 
see, FujiBoink! proper hardly does any 
work. 

TRANSPARENT 
SHADOWS AND 
DISPLAY STRUCTURE 

The ST uses a bit-plane display stRic- 
ture. In low resolurion, four 320-by-200 
bit-planes are used (see Figure 2). The 
principle behind the transparent 
shadow is this: draw the background 
grid on plane 0, do all animation in 
planes 1 to 3 (leaving plane alone), 
and with the proper color register as- 
signment, voila! Transparent shadow. 

Perhaps an example will help to elu- 
cidate matters (see Figure 3), In this par- 
ticular case, the shadow of the fuji is 
represented by pixel OOlx binary. 
What's with the "x"? Well, the shadow 
is drawn as 0010 pixels, but only the 
three most significant bits are saved; the 
least significant bit effectively merges 
with plane 0, the grid. This way, the 
color of the shadow will depend upon 
what it overwrites. The fuji's face is 
pixel OlOx, and empty space around the 
fuji is OOOx. 

Now, if at a particular point the grid 
is (white), the situation will be empty 
space (0000), shadow (0010). and face 
(0100). Therefore, color register 
should be white, register 2 should be 
grey, and register 4 should be whatever 
color the fuji's face is supposed to be If, 
however, the grid is 1 (red), the empty 
space pixel will be 0001, shadow will 



be 0011, and face will be 0101. Color 
register 1 should be red, register 3 
should be a dull red, and register 5 
should be the same as register 4, be- 
cause the color of the fuji's face does 
not depend on the grid. On the other 
hand, the colors of empty space and the 
shadow do depend on the grid, and by 
using bit-plane to select appropriate 
color registers, the transparency effect is 
easily produced, 

OVER THE RAINBOW 

The rainbow effect, which is so easy on 
the 8-bit Atari's, posed two major prob- 
lems on the ST: how to change the fuji's 
color on the fly and what to change it to. 
The first problem was solved in Tom 
Hudson's ST Color Palette article (ANA- 

SCREEN MEMORY 

I y^ORD P I WORD i I WORD 2 | WORD 3 | 



LOG ma^zine, January 1986), The 
technique consists of programming the 
68901 Multi-Function Peripheral chip 
to generate an interrupt every scan line. 
The interrupt service routine can then 
stuff new color values into the color 
registers. This is not the way Atari 
recommends doing this. Their method 
uses the built-in HBLANK (Horizontal 
Blank) interrupt. Unfortunately 1 was 
unable to get that method to work, so I 
left well enough alone, and went to bed. 
The second problem was an esthetic 
one. When the Si's 512 colors are laid 
out in RGB order (blue var)'ing most 
rapidly), the rainbow does not really 
look so hot. The order I finally setded 
on is generated thusly (in pseudo- 
pseudo-code): ^ 




IT FROM PLANE 
BT FROM PLANE 1 
i'lT FROM PLANE 2 
BIT FROM PLANE 3 



FIGURE 2 ST iow-yf^ohaion display 
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The red component is multiplied by 
three to provide a little more variety in 
the rainbow. 

CALCULATING 
SHADING 

This is embarrassing. This part of the 
project took nearly four days, mosdy 
because of my own stupidity (Sample 
mental process to convert 90 degrees to 
radians: Well, 90 degrees is one-quarter 
of a circle, so in radians that's one- 



quarter pi, right? AAAARRRGH!) This 
was also the time I discovered that Al- 
cyon C wouldn't let me initialize a float 
array, and that the arc-tangent function 
atanC) wouldn't link. More 
AAAARRRGH! 

The idea was to generate realistic 
coloring on the side of the fuji, for each 
scan line of each view, according to the 
lollowing formula: 
brightness=d'*cos( i )-l-s*cos( a )" 

where: 
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d IS strength of diffuse reflection 

(70%) 

i is angle between light source and 

surface normal 

s is strength of specular reflection 

C30%) 

a is angle between reflected light 

and sight vector 

n is 5 

1 didn't make all that up. I got it out 
of a book (see Reference). 

Each brightness value is mapped 
onto an ST color, starting from dark blue 



at the low end, through light blue to 
white at the high end. The interrupt 
routine described above also stufls the 
fuji side-color registers. 

THOSE GREAT SOUND 
EFFECTS 

I know. 1 know, there's only one sound 
effect, and yes, I agree, it's not so great. 
Maybe next time. 

ETCETERA 

FujiBoink! is written mostly in C. The 
3-plane block move and clear routines 



and the interrupt seivice routines are 
written in assembly language. Those 
who wish a detailed, technical explana- 
tion of the coding are invited to dissect 
the source code on the START disk. 

(Editor's note: START is interested in 
seeing any vanatioiu on FujiBoink! that 
readers come up with. How about a custom 
data generator?) 

REFERENCE: 

• Procedural Elements for Computer 
Graphics by David H Rogers, Os- 
borne/McG raw- Hill, Berkeley, CA, ■ 



CREATING 






AND RUNNING 






FUJIBOINK 


1 

• 


/ Chck and run PEND.PRG. U will 
QJ bind the other three data files into 
one nSKfile called FUJIB01N.D8A. 


FujiBoink! requires a datafk over 118K 


O MPORTANT! Set your STs rcsolu- 
^ tion to Low. Some of the data crea- 


Once you have your final 


in si^e; which is far too large for the 


FUJ1B01N.D8A FILE, you may delete 


START disk. The FUJLSTQ folder holds 


tion programs do actual screen grabs. 


the other three .D8A files. (PFNUPRG 


three pragfums that create separate por- 




will display a couple of bombs before 


tions of the data and a fourth program 


O From the disk you just moved the 
\J sixfiles to, double-click and run 


returning to the Desktop Tiy to pretend 


that binds them into the final data file. 


this didn't happen, ll won't affect the 


The following instructions will getyour 


FUjIDRAW.PRG. This program will cre- 


final result.) 


fuji up and boinking. 


ate a scries oj fuji's on the screen and 






write them to a data file called 


7 Copy FUjIBOlN.PRG to the same- 
X disk as FUJIB01N.D8A. These are 


1 Open the FUfi.STQ folder on your 
/ START disk and copy the following 


FUJIDRAWD8A. The whole process will 


take about seven minutei. 


the only two files you y\eed to nm 


files to a blank, formatted disk. 




FUflBOINK. 


FUjIDRAW.PRG 


A Now, run FUflSHAD.PRG, which 
^T will create a data file called 




FUJISHAD.PRG 


Q You're done! Click and run 
O FUJIBOIN.PRG to see the dema 


CETTITLE.PRG 


EUjlSUAD.DSA. 


PEND.PRG 




While ru?ining, you may press any func- 


TITLE.NEO 


JThlext, mn GETTITLE.PRG. This 
J will display the TiTLE-NEO pic- 


tion key to freeze or restart the bouncing 


FUJIBOIN.PRG 


fuji. Press the Space bar to return to the 




ture and capture a portion of it to a file 


Desktop. 




called TITLE.D8A. 
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A-FILER/REPORT 
WRITER 

If you can click your mouse you can run 
this Filer/Report Package 

This package is an extremely powerful GEM based 
mouse driven dala base and report writer. The business 
applications are endless, it has 24 fields, disk based for 
unlimited number of records, and the ability to do dollar 
and decimal point calculations. Standard ASCII D-8ase 
and other data base files can be used, The Report Writer 
can be used for any custom forms like invoices, labels, 
CO-D, tags, visa slips, statements and inventory 
reports, to name a few. It's easy... just grab the field with 
your mouse, put it where you want it and, ..elicit! That is 
where it will appear on the forms you print. 



$49.95 



A-MAILER ST 



At last a Mailing Labeling program that is not only super 
powerful, but also Mouse driven and easy to use. This 
program Is NOT Ram based so you can have as many 
records as your disk drive can hold. One of the many 
powerful features includes the ability to insert into a 
field text that was a prior record just by hitting the TAB 
key. Other features include 9 fields, labels tor 1, 2, 3 
across, ability to custom size your labels and port over 
D-Base or other standard ASCII mail lists. This program 
also Integrates with the Graphic Label Maker. 



GRAPHIC LABEL 
MAKER ST 



$39.95 



This package will allow you to use graphics when 
printing your address labels. It even gives you different 
typestyles. This program will interface with both the 
A'Mailer and XXXXX Rated Graphic Data Disk for those 
unusual labels. 




^ I Now 

1 Available 
^ For the S.T. 




rp^/SP.AtferT ST TOOIS which will 



lo piQcy /our Dfde, hy phone (206) 487.7176 or in Canada call 
Fo,M„,iO,d=„: $39.95 



MegciSoH: 



In Canada: MegaSoft Canada no 

P.O. Box 10 

Parry Sound, Ontario 93A )P( 



RAM DISK AND 
SPOOLER 



$39.95 



Both the Ram Disk and Spooler are included in one package 
for one low price. They are both completely transparent to your 
operation. Ram Disk will even allow you to press the reset 
button to interrupt a running program and preserve the Ram 
Disk contents. The Spooler wHi allow you to continue to use 
your computer while the printer is in operation. 



ST TOOLS 



$39.95 



ST Tools is a complete utility package for the ST, This package 
Is completely GEM based and mouse driven. ST Tools will 
allow you to do just about anything with the ATARI DISK 
DRIVE. Some of the options included in this program are; 
COPY, MOVE, EDIT, RENAME, COMPARE, UNERASE, ERASE, 
CHANGE STATUS, CHANGE LABEL, FORMAT, and RECOVER 
ERRORS. Also included are hard drive utilities. 



XXXXX RATED GRAPHIC 
DATA DISK ST XXXXX 



$29.95 



These graphics work with your Print Master or Graphic Label 
Maker ST. There are over 60 entertaining graphics on this disk. 
They can be included with anything you can make with Print 
Master and Graphic Label Maker ST. (labels, letterhead, 
banners, cards, announcements, and many more) 



TELECOMMUNICATIONS 
PACKAGE 



$39.95 



This package is a total package that includes all the features 
of the more expensive packages. Options include: spooling, 
printer dumps, phone book, 300, 1200, 2400 and 9600 baud 
rate, up/down load, and x-modem with remote access. 
Included in this package is the Wargames Auto Dialer, 
Wargames will help find other local computers with modems 
on them. 



Oealsr and Distributor Inquires Invited. 



Enclose Cashiers Check, Money Order or 
Personal Check. Allow 2 to 6 weeks for 
delivery. 

S3.0QSa Hon all orders 
Sollwaro Submissions Invited 


y/sA 




(MottarCordj 









To place your order by ptione Call (206) 687-7176 
or in Canada call (705) 746-8081 



rui riidiL ijiucia. 

MegaSoft 



or in Car^ads: MegsSoft Canada LTD 

P,0. Box 10 

Parry Sound. Onlario 92A 1P8 
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THE WAIT rS OVER! 

MT C-SHELL 
IS HERE. 

MAIN FRAME PERFORMANCE 
FOR YOUR ST . . . 

• Multiuser and Multitasking 

• Electronic Mail 

• Print Spooling 

• Unix Like Environment 

• And it Runs TOS Programs 

$12995 

COMPLETE 

jm^ Beckemeyer _ 

'••' Development Tools a^ 

592 JEAN STREET, #304, OAKLAND, CA 94610 
415/658-5318 



18 ON READER SERVICE CARD 



ProCopy I 

FRODUCTORY OFFER ' 



BACKUP 
UTILITY 



INTRODUCTORY 

$24 '5 ST 

Regular S34.95 Offer ends July 31, 1986 

Software can easily be damaged by heat, humidi- 
ty, magnetic fields, wear & tear or just dirt. The ex- 
posed surface of a disk con be affected by even a 
touch. The best way to preserve your software is to 
make backups. ProCopy provides the solution. 

■ Duplicates virtually any protected disk. 

■ Reasonable update policy available. 

■ Protects against accidental loss of 
expensive software. 

■ Not copy-protected for your convenience, 
m ProCopy v/orks on all Atari ST computers. 

ORDER TODAY AT THIS REDUCED RATE 
Send S24.95 {check or money order). VISA h^ 
& MC accepted. Add $2.00 shipping & Jjg^ 
handling in U.S. & Canada. Overseas ship- ,. 
ping fit handling add S4.50. ,,«™,.rt:ori; 

Atori ST Is o reolsleted trodemarh or Alan Corp. : i i) 

Available Only From 

PRO ^OTS 

P.O. BOX 665 

CHEPACHET, RHODE ISLAND 02814 USA 

(401) 568-8459 




Winners DSDD 3'/^" $25.50 

Maxell SSDD3'A" $1150 

SonySSDD3■^" $17.50 

Maxell DSDD 3'/i" $2150 

SF 314 Disk Drive $19Z77 

SF 354 Disk Drive $12477 

SM 804 Graphic 

Printer $177.77 

SH D 204 20 mb Hard 

Disk $627,77 



ST MONO SYSTEM 



' 520 ST Computer 
• 124 Mono Monitor 
' SF 354 Disk Drive 

I Logo 

■ First Word 

$499.77 



ST SOFTWARE 



Kings Quest II $31.77 

Homework Helper 

Math .$31.77 

Financial Cookbook . , , , $33.77 
Little Computer 

People $33,77 

Music Studio $36.77 

Mind Shadow $28.77 

Winnie The Pooh $14.77 

Brataccus $27.77 

Checking Account 

Manager $44.77 

Rogue $23.77 

D.E.G.A.S $23.77 

Habba Writer $4377 

Ultima II $17.77 

Hacker $25.77 

Art Gallery $18.77 

Print Master $23.77 

Borrowed Time $28.77 

Habba View $43.77 



Video Digitizer for the 

520ST/104OST $177.n 

Convert Video Signacs for 

Computer Reproduction 



Color & Mono 

Systems 

CALL FOR BEST 

PRICING 



ST COLOR SYSTEM 




THE PAWN $27.77 



TO ORDER CALL TOLL FREE 

1800 233 6345 

BETWEEN 9 A,M.-6 P.M. EST 
MONDAY THROUGH FRIDAY 

In Florida calK,305)500-1364 

^■■■■■■■■■e^ ^ . ..^■■■■■■■■■« 

■■■■■■■■■■iiiaaaBhRHHriUHiHBN«h>«yyillllllll' 
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Arick Anders has been developing 
IBM PC educational products for the 
past two years with a company 
called WICAT in Orem, Utah. The 
touch-typing program he developed 
is now being marketed by the IBM 
educational division. Arick received 
his B.S, degree in Computer Science 
with a minor in Chemistry from 
Brigham Young University. On the 
weekends he is a medic with the Na- 
tional Guard and during his spare 
time he raises English Angora rab- 
bits, three children and cries to keep 
up with his wife. She is a registered 
nurse and works in the emergency 
room of the local hospital, 

Michael Bendio works for Hart 
Scientific, writing data-acquisition 
software. He has been a professional 
programmer since 1978 and received 
degrees in Comparative Literature 
from Brigham Young University and 
the University of Chicago. He's been 
fascinated by computers since he 
read the Popular Electronics con- 
struction article for the MITS Altair 
His first computer was the Processor 
Technology SOL with 2K of RAM 
and a binary switchbox for a 
keyboard, 

Christophe Bonnet of France is 

a 21-year-old university student 
studying physics, electronics and 
(suiprise) computers at the Univer- 
sity of Marseilles. His six years of 
computer experience have involved 
work on the Apple II and the Macin- 
tosh, He wrote Reversi after some 
four months with the Atari ST. He is 
currently at work on a 3D graphics 
program for the ST. 

Christophe also has an interest in 
war-simulation games and tentatively 



plans to develop his own, following 
completion of the graphics project. 
When the computer is down, 
Christophe heads for the tennis 
courts or the slopes. He lives with 
his family in Marseilles. 

Christopher Chabris appeared 

in the premiere issue of START with 
"ST Assemblers-A START Compari- 
son," A student of computer science 
at Harvard University, Christopher 
maintains a strong interest in 
artificial intelligence and is complet- 
ing a book on the subject which will 
be published in 1987 by Dow Jones- 
Irwin/Mulciscience Press. 

Christopher is among the top 50 
chess players in the United States 
under 21 years of age. His knowledge 
of programming languages includes 
68000 assembly, LISP, and PROLOG. 
Christopher has owned one of every 
Atari computer as far back as 1980, 
"with the exception of the 12O0XL." 

Ian Chadwick has been writing 
about computers since 1979. His ar- 
ticles have appeared in the Toronto 
Star, Softside, Antic, Analog, Com- 
puter Gaming Worid, and other pub- 
lications. He was an editor on the 
Canadian computer magazine, Info- 
Age, and was the trade book editor 
for Holt, Rinehart & Winston of 
Canada. He is best known as the au- 
thor of Mapping the Atari, published 
by Compute! Books, and of software 
manuals for Antic, Batteries Included 
and other publishers. 

Ian lives in Toronto, Canada, with 
his wife Susan, their six cats and one 
dog. He is now writing mystery 
fiction and trying to teach his dog to 
play chess. 



Jim Dunion was a programmer 
with the "old" Atari, where he first 
worked in the Software Development 
Support Group, then later in Alan 
Kay's research group. He has been 
with computers since the first days 
of microcomputers and was founder 
of Peachtree Software in Atlanta, 
Georgia. Presently, he is with The 
System Works in Redmond, Wash- 
ington 

Jim designed Dunions Debugging 
Tool, considered by many to be the 
best debugger for the 8-bit Atari, and 
is now working on an ST version to 
be called STDDT 

Tom Hudson is the author of 
DEGAS, CAD-3D, and the new 
DEGAS Elite. He was head of pro- 
gramming with Analog ma^zine 
from 1982 to 1985 before leaving to 
become a free-lance software de- 
veloper In our premiere issue, Tom 
wrote "Stealing the ST Printer Driver^' 
a multi-printer screen-dump desk 
accessoiy. 

Tom's Erst computer was an IBM 
1620 that he played with in high 
school. He worked his way through 
college teaching computer neophytes, 
then landed a job as program- 
mer/operator at a savings and loan 
white earning a BS in data process- 
ing. Tom lives in Mission, Kansas 
and is a SYSOP in the 16-bit Atari 
section of CompuSen'e, 

Harry Koons first programmed the 
IBM 704, 709 and 7090 mainframes 
while attending MIT There, he 
received a BA in Physics and a Phd 
in Geophysics before moving 
directly to The Aerospace Corpora- 
tion where he remains employed as 
senior sciennst building instruments 
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for satellites. "There are about hall-a- 
dozen major satellites orbiting the 
earth with my equipment on board." 

Harry developed several award 
winning products for the original 
APX (Atari Programmer's Exchange) 
line, including Mapware and Star- 
ware His ST programs include Maps 
and Legends, and The Astrologer 
(available from The Catalog), Harr)' 
is also the author of The Tax Advan- 
tage, for the 8-bit machines, and is 
currently working on a tax program 
for the ST planned for next tax 
season. 

Alex Leavins built his hrst com- 
puter when he was in the fourth 
grade It added, subtracted, multi- 
plied, and divided binary numbers. 
"It was a real primitive calculator and 
it was about the size of an Atan 800. 
But it worked." Alex went on to 
graduate with a BS in mathematics at 
the University of Chicago. From 
there, he worked at Midway 
Manufacturing, designing Atari 2600 
games. He then branched out on his 
own forming Dynamic Software 
Design, 

Alex's interest in text adventures 
goes back some years-he 
coauthored Wombats and Wombats 
n, two satirical Infocom-style text ad- 
ventures written for the Atari 8-bit 
computers. Alex recently joined 
KnowledgeSet as a software engineer 

Daniel Moore, along with partner 
Steve Ahlstrom has written several 
programs for the 8-bit Atari's, includ- 
ing Paperclip and Synfile. Dan recalls 
his first computer was a Hewlett 
Packard 2114B in high school: "It 
was the size of an extra-large, legal 
file cabinet and contained 8K words 
of memory. Ic used paper tape and a 
30-line Fortran program took three 
hours to compile" 

Dan attended the Colorado 



School of Mines, "We were six 
blocks from a Coors brewery and I 
remember waking up in the dorm, 
opening the window and taking a 
deep breath of Rocky Mountain 
hops." Dan is cun*endy working on 
the Hometexi ponion of Russ Wet- 
more's HomePak for the ST, and on 
Paperclip Elite for the ST, 

Tim Oren wrote "Trackmg the Elu- 
sive GDOS" in the first issue of 
START, He was one of the original 
designers of the GEM system at Digi- 
tal Research, working on the AES 
portion and sections of the Desktop. 
Tim also implemented the Resource 
Construction Set as well as much of 
DOODLE, 

Tim has a master's degree from 
Michigan State University, He is the 
author of ST PROFESSIONAL GEM. 
a regular GEM programming column 
that you can read on .ANTIC ON- 



LINE, a CompuServe information 
sen'ice. As this START went to press, 
Ti m had just accepted a position 
with a major Silicon Valley firm. He 
plans to spend his free time hiking 
throughout the Santa Cruz 
mountains. 

Mark Skapinker is Director of 

Product Development ar the Cana- 
dian software firm, Batteries In- 
cluded, He is author of Thunderi 
and coauthor of the Isgur PortfoHo 
System. Mark was raised in Africa, 
where he studied psychology at Wit- 
watersrand University in Johannes- 
burg, He later emigrated to Israel, 
where he lived in a kibbutz for a 
year while doing postgraduate work 
in computer science. 

Mark's first computer job was de- 
veloping software for CP/M 
machines with NISN Information 
Scn^'ices in Tei Aviv. There, he ► 




BACKUP PROTECTED 
SOFTWARE FAST. 

From the team who brought you 
COPY II PLUS (Apple), COPY II PC 
(IBM) and COPY II MAC (Macintosh) 
comes a revolutionary new copy 
program for the Atari 520 and 1040 ST 
computers. 

• Copies many protected programs— 
automatically. (We update 

COPY li ST regularly to handle new 
protections; you as a registered 
owner may update at any time for 
$15plus$3s/h.) 

• Supports single and double sided 
drives. 

• Includes both a fast sector-based 
copier and a true bit copy mode for 
protected disks. 



Requires an Atari 520 or 1040 ST 
computer with one ortwo drives. 

Call 503/244-5782, M-F 8-5:30 
(West Coast time) with your 2S ^9 
jn hand. Or send a check 
for $39.95 U.S. plus $3 s/h, $8 
overseas. 

$39.95 



Central Point Software, Inc. 
9700 S,W, Capitol Hwy #100 
Portland, OR 97219 

CeritralPohit 
Softanre 



(IB[lE010 0NREj!iDERi5tRi'lf£[ABIl 

Backup utilities also available tor the IBM, Apple II, Macintosh and Commodore 6 
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learned by necessity to program 
microcomputers to accomplish tasks 
done elsewhere by minicomputers- 
Mark lives in Toronto, Oncario with 
his wife, Hazel, and daughter, Lisa. 

David Small has contributed a 
wealth ol technical articles to various 
computer magazines, including Crea- 
tive Computing, Antic, and the first 
issue of START (Voodoo Computing). 
He has three books, including 
"Guidebook for Winning Adven- 
tures" (Baen Enterprises, N,Y., NY) 
which he coauthored with his wife 
Sandy. Their fourth book is expected 
out in January 1987- 

David discovered how to make 
the Atari ST into a Macintosh (much 
to Apple's chagrin) and hopes to get 
the "MacCartridge" to market soon. 
He has worked for several computer 
companies and is now a consultant, 
freelance writer and busy father of 
two children. 

Xanth Park is not a person, but a 
collection of talented programmers 
Situated in downtown Seattle, 
XANTH is the largest ST retailer in 
the state of Washington. It begin- 
and shil partly exists -as the XANTH 
SSI (Seatde ST) User's Group, A tittle 
over a year ago, the group be^n sell- 
ing Atari 130XE's and have since be- 
come a full computer store 

The XANTH programmers, hav- 
ing evidendy tired of wowing the ST 
communit)' with graphic demonstra- 
nons, are currently putting the 
finishing couches on a multi- 
computer, point"of-view, 3D maze 
^me. Although they cherish 
anonymity, they welcome corre- 
spondence: 

XANTH Computer Systems 

600 First Avenue 

Seattle, WA 98104 

BBS: (206) 682-8039 ■ 



nncK 

VOUR 
BRniNS 





Available for the Atari 
520ST or lOAOST; 
Color monitor required 



Jo order: 

Contact your A tari ST 
Dealer or send 
$34.95 pius $3.50 

for shipping and 
liandling to: 

Shelbourne Software 

7221 Rising Sun Ave. 
Suite 191 

Philadelphia. PA 19111 
(215) 725-5644 

(PA residents add 6% sales 
tax. Visa and MC accepted) 



Atari 520ST & 1040ST reg- 
istered trademarks of Atari 
Corp. ST-Pool is a regis- 
ter&j trademark of 
Shelbaume Software. 

Dealer ir^quines accepted. 
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UMiVEH 



EWTER A NEW WORLD of unprecen- 
(Jenied depth and excitement wdh 
Omritrend's Unrverse II. It's quite unlike 
any game you've ever seen before, 
combining ine thrill of roie playing 
with the depth of story possble only in 
text adventures. 

^tu are a free trader in a cluster of 
known as lUe Local Group. Through 
sharp trading, mining, passenger 
transport, and orbital piracy, 
you'll try to earn money 
to fuel your ship, pay 
your aevj, rep; 
parts, acquire ad- 
vanced technol- 
ogy, and perhaps 
buy a new space- 
craft. 






Unknown to most 

your crew, you are 

also an active deep-cover agent 

for one of the governments in the Lo- 
cal Group. As the interstellar situation wors- 
ens, you'll be called upon to carry out covert 
operations deep within enemy territory. 

Universe 11 is available for the Atari ST. Apple II, Mac- 
intosh, and IBM computers. Price: S69.95. Also from 
Omnitrend: Universe I far the Atari XUXE. Apple II, and 
IBM computers. Trice S59,9S. 
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Improve your 520 ST's 
performance 

with the ThouQhtSPQce TS- 1 A 
one megabyte expansion board 

The TS-IA gives you greater speed and 
power. Bigger documents and applications. 
More desk accessories, Larger RAM disks, 
Fuil 1040 ST software compatibiiity, 

Whether you have it instolied or do it 
yourseif, you get o compiete, tested board 
with a utilities diskette ond detailed 
instructions. 

The TS-IA is of the highest quaiity, comes 
with a one year guarantee, and is simple to 
instoll. 

Call or write for literature, dealer list, and 
ordering information, 

only $150 C+S is installation) 



D^¥€?lopm^nt 

2450 Warring St., No. 21 Berkeley, CA 94704 

(415) 845-1415 

Dealer inquiries invited! 
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ATARI ST 



ACTION P AK° 

4 Atari ST™ Programs 

I Low Price! 

Disk Labeler 

Custom design your own unique 3.5 inch disk labels. 

- Create professional-looking labels using three 

windows on screen. Fully mouse driven. 
:. up to 38 " files on eacti label, aiphabetically with 
monochrome monitor. UptolSfJieswilh color monitor. 

► 35 borders and 4 type styles'. 

►■ Includes 50 pin feed disk labels for 3,5 inch disks. 

► Uses ST's full graphics capabilities* . 

Banner Maker 

Express yourself! Create original 1to4 line banners 
up to 72 characters in iengtti. 

■■- includes Stonts. Custom design your own with 
Degas"" or use any fonts compatible with Degas'*. 
Left, right or center justification. 
Does not require "Action Pak [4 in 1)" " " to print 
banners. Banner files can be given on disk or sent by 
modem. 



Great for addressing envelopes, filling out forms or 
writing short memos. 

► Turns your ST into a line-at-a-time typewriter. 

► Always handy! Resides in RAM as a desk-top acces- 
sory or runs as a stand alone program, 

Synfile** Converter 

A real work-saver! Convert your 8-bit Synfile ' * files 
fast without having to reenter data. 

^.■- Creates ST files compatible witti Hippo Simple"", 
Zoomracks", DB Master One" ", H & D Base", DB 
Man", dbOne". or Regent Base", 

► Easy to usel Completely self-prompting. Just answer 
the simple questions, 

► Requiresmodemor null modem. 

Available at your local ST retaifer. tf you are unable to j 
find it, then send coupon to: Action Software — 
69 Clementina, Dept, SA, San Francisco, CA 94105. 
Please include $3,00 shipping & handling, Calif- 
residents please add 6.5% sales tax. 

G Check enclosed 



II my credit card: L VISA D MC 



I Address _ 
I Clty_ . 



Credit card no. . 
Signature 



_ Exp. Date _ 



We are lool<ing for quality ST programs to publish. 
Call (415) 974-6638. 

■Requires Epson'" or Epson" ' compatible graphics printer, 
Oltier non-Epson" compatibles will print up to 18 file names, but 
may nol accept graphics. 
' '"Action Software. AtsrE Corp., Batteries Included. Synapse Soft- 
warG, Quickview Systems, Mirage Concepts, Versasofl Corp., 
Oxxi, Inc., Reganl Software and Epson Corp, respectively. 
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RESO URGES 



^^F TART supports the efforts of the 
whole Atari ST communiry. In our 
Resources section we will help you find 
sources of information and assistance to 
make your ST computing more reward- 
ing. If you want START to publish your 
message, address your request to START 
Resources, c/o Antic Publishing, 524 
Second Street, S.F, CA 94107. Well do 
what we can, but no promises. 

INFOTREE 

Modem owners should know that Atari 
has a Bulletin Board System, (408) 
745-5308. Some other BBS numbers for 
ST owners are available from BUG, the 
Boise Users Group. Their BBS number 
is (208) 383-9547. ST boards are inter- 
mixed with Atari 8-bit boards, but they 
are identifed as ST. Be prepared for a 
sizable download. 




DOWN TO BUSINESS 

The ST is a capable business machine, 
and chat's the angle ST Business takes. 
This new publication bills itself as The 
Independent Publication for Atari Small 
Business Computer Owners, For more 
info write Don and Carole Terp, Editors, 
at 5140 Appletrec Drive, Roanoke, VA 
24019. 

FESTS and FAIRS 

Atarifests and Atari Fairs are popping up 
all over Usually these are annual shin- 
dig sponsored by a coalition of users 
groups in a large geographic area. For 
example, five groups from northern Cal- 
ifornia will meet at the San Jose Con- 
vention center on Sept, 20 and 21, An 
Atari fair in Pordand, Oregon is slated 
for Oct. 17-19. If you know of special 
Atari events coming up, give us plenty 
of notice and we'll iry to announce 
them 

WHAT'S IN A NAME? 

Just as ACb (meaning Atari Computer 
Enthusiasts) became a common suffix 
for many Atari 8-bit users groups 
(MACE. SPACE. PACE, etc.), ST'ers may 
find STING useful (ST INformation 
Group), The first STING we know of 
serves the southern Illinois area: contact 
David Stambaugh, 109 Florida St.. 
Washington IL 61571. Thus, the COAST 
users group (California Original Atari ST 
etc.) could become COASTING. Howls 
of rage can be registered with Chuck 
Thorp, COAST president, 1015 Esther 
Drive, Pleasant Hill, CA 94523, Their 
newsletter is called FirST, and costs $2 
per month for nonmembers. 

Another group we've heard of calls 
themselves Jbug, which somehow trans- 
lates to Atari ST Users Group of the Bos- 
ton Computer Society. Call (617) 296- 
8286 for information. 



HANDBOOK 

The 'Atari ST User's Handbook," by Gil- 
bert Held, is available for $9,95 from 
Weber Systems Inc., 8437 Mayfield 
Road, Chestedand, OH 44026. It's 160 
indexed pages are well illustrated to 
show the new user how to set up the 
system and use the GEM Desktop. It in- 
cludes a chapter on programming in 
Logo and one on data communicadons. 
The book mostly covers material al- 
ready in the owner's manual, but does it 
better, if that's what you need. 

OVER THERE 

j'opularity of the Atari ST in England is 
evidenced by S"r User, a monthly maga- 
zine from Dufose Publishing, Ltd., 43 
South Street, Chichester, West Sussex, 
P019 IDS, England. Americans can 
subscribe for 36 British pounds per 
year The content is heavy on reviews, 
with some tutorials and type-in 
programs. 

OUR OWN HORN 

ANTIC ONLINE, an electronic miorma- 
tion service of Antic Publishing, is car- 
ried by CompuServe Our refurbished 
menu offers ST-specific news, reviews, 
and product informadon. Simply log 
onto CompuServe, type GO ANTIC and 
look for the ST Secdon. Antic also sells 
ST software through the mail; see our 
offerings elsewhere in this issue. 

THE BOYS ARE IN CHARGE 

Local computer tabloids are doing well 
in several markets. MicroTimes, Califor- 
nia's (free) Computer Magazine, featured 
the STs and interviews with Sam and 
Len Tramiel in itsjuly, 1986, issue. Co- 
pies may still be available from BAM 
Publications, 5951 Canning St., Oak- 
land, CA 94609. 
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that won't blow your budget 




Create double- if^^ 

sized pictures T ^ 
Fohra 



FilePro 



The electronic 
filing system 
"~^ for the ST 




PaintPro is a friendly, yet powerful design and 
painting pacl<age for drawing graphic and artistic 
pictures. Ttiis GEM-based package supports up to 
three active windows — cut & paste from one 
window to anottier. Compiete tooii(it of functions: 
free-form sl^etcfiing, iines, circles, ellipses, boxes, 
fill, copy, move, spray, zoom, undo, fielp and 
extensive text capabilities. Import "foreign" 
pictures for entiancement using Paintpro's 
double-sized picture format and send hardcopy to 
most popular dot-matrix printers. PaintPro works 
with either monochrome or color systems. $49.95 



FilePro is a simple-to-use but powerful data 
management system. Drop-down menus to 
quickly define your file and enter information. 
FilePro has many features that make it unique 
and flexible: store data in different type styles; 
create subsets of a file; change file definition and 
format; includes a RAM disk for high-speed 
operation. Has a fast search and sort capabilities, 
handle records up to 64,000 characters, 15 
significant digits for values, access up to 4 files 
simutaneously, index up to 20 different fields/file 
and has complete report capabilities. $49.95 



Other sensational 
ST software available: 

ST Forth/MT - Powerful, full-featured, multi-tasking Forth. 
32-bil implementation based on Fortti83 standard. Full screen 
editor, monitor, macro assembler. 1500+ word library. $49.95 

ST Text Designer - Ideal package for page layout. Accepts 
prepared text files from TextPro, other ASCII wordprocessors. 
Perform block operations — copy, move, columns. $49.95 



ST AssemPro - Professional developer's package. Editor, 
interactive two- pass assembler with error locator, online help, 
monitor- debugger, disassembler, 68020 simulator. $59.95 

ST TextPro - Wordprocessor with professional features and 
easy-to-usel Full screen editing, sideways printing; multi- 
column output; automatic index and table of contents. $49.95 

PCBoard Designer - Interactive, computer-aided design 
package for pc boards layouts. Auto-routing, plnout & 
component list. Two-sided boards. 45° & 90° traces. $395.00 



Call now tor the name of your nearest dealer. Or order directly 
with your t^C, VISA, or Amex card. Add $4.00 per order for 
postage and handling. Foreign add $10.00 per item. Other 
software and books coming soon. Call or write for your tree 
catalog. Dealer inquiries welcome-1400 dealers nationwide. 



Abacus liiiil Software 



Phone (616) 241 -5510 -Telex 709-1 01 
P.O. Box 7219 Dept. TA Grand Rapids Ml 49510 
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RUSSIA 



And you don't even have to 
leave your room. 

Tlie Russians have The Doomsday Papers"' locked 
deep in a Siberian stronghold. With them, tliey can 
iiring the world to its knees. 

Tlie U.S. government needs your help. Using their 
satellite you can get into the complex with your 
computer. All you have to do is locate the combina- 
tions to the safe, find and open it, and get the 
documents out. 

Sounds simple enougli. Untbrttmately it's not that 
easy Tliere are video cameras and monitors to be 
avoided- Guard patrols. And something called . . .Tlie 
Annihihilor Plus, your only map is the one you've 
got to make while not being discovered by all of 
the above. 

Your reputation got you into this mess. Your 
hacking skill is the only thing that can get you out. 
Bon Voyage. 

Tor more information and the dealer nearest vou eall 800/ 
22%9759 {in California, call 415/96()-0-+10) wt-ckdays 
10:00 a.m, to 4;00 p.m. Pacific time. 




Hacker IL'Ilic Doomsday 
Papers designed by Steve 
Cartwriglit, who brought 
you the aw;ird winning 
challenge of Hacker™ 



Hacker 11 for Commodore 
64/128, Apple II, IBM 
PC/PCjr and Tandy 1000, 
Amiga, Atari ST and 
Macintosh computers. 



ACTIVISION 

i:NTY.RTA"lNMi:NT SOI- liVAKE 



Commodore 64, 128 and Amiga are trademarks of Commodore Electronics Limited. IBM is a trademark of International Business 
Machines Corporation. Tandy is a trademark of Tandy Corporation. Atari and ST are trademarks of Atari Corp. Apple and Macintosh 
are trademarks of Apple Computer. Acti\'ision is the registered trademark of Acti\'ision, Inc. '0 1986 Activision, Inc. 
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The author of DEGAS™ enters a new dimension. 



Tom Hudson's 



A fuU, three-dimensional modeling 
station for your ST. SoUd modeling, 
with shading from three adjustable 
light sources, plus wireframe and 
hidden surface dimensional sculpt- 
mg—you name it All your 3-D graph- 
ics fantasies have been poured into 
the power and speed of the ST's 
68000. So step on the gas and take 
offr 



starships to solar sys- 



animate views of your 

own 3-D objects. And no 

keyboarding here-CAD-3D is 
entirely GEM-based. It's got to be 
seen to be believed. 
BESIGNERSi You now have power 
at your fingertips that was pre- 
viously available only on systems 
costing $30,000 or more. Visualize 
ideas instantly— apeedn up design 
process. 

DOODLERSt Easy to learn, easy to 
use. Create the ultimate In dlmen- 
sionalscenes. Then detail them with 
any ST paint program. 



C AD-3D features include: 

D Works with monochrome or color 
monitor. Monochrome mode 
gives 16 levels of shading, color 
gives choice of 1 color/14 shades 
or 2 colors/? shades each. 

D View objecto in see-thru or liidden 
wireframe form or solid form 
with true light shading. Change 
objectf orm withone mouse click. 

D Three independent user-defined 
light sources plus ambient 
lighting. 

a Built-in 3D primitives (cubes, 
spheres, toroids, wedges). 



continued on next page 
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O Automatic JOINER creates more 
complex objects: 
ADD objects together 
SUBTRACT one object from 
another 

AND objects (retains only the 
intersection) 

STAMP one object on another 
D Create radially symmetrical objects 
or expand 2D shapes into 3D shapes 
with one mouse click, 
Q Animation capability— "record" view 
sequences for viewing withseparate 
display program (included). 



□ Spin and Extrude functions allow 
even the novice 3D experimenter to 
create a wide variety of beautiful 
shapes (includes 'Snap To' grid). 

D Independent scaling and rotation of 
objects or groups of objects. 

□ "Camera View" includes zoom lens 
and variable perspective. 

□ GEM user interface allows use of 
four views at once, or one large view. 
Four-view mode is user-definable. 

n Save completed images in DEGAS, 
Neochrome or COLR Object Editor 
format. 



□ Print your objects with a graphics 
printer. 

n Detailed illustrated user manual. 

□ Sample complex objects included, 
featuring Ian Chadwick's STONE- 
HENGE {circa UOQ EC). 



Requires TOS In ROM 
ST0214 

DESAS'M Batteries Included 



$49.95 



INCREASE YOUR DESIGNING POWER WITH CAD-ZD ACCESSORY DISKSI 



FONTS, PRIMITIVES, 
HINTS AND TIPS: 




n Create logos, signs, 3D letterheads and 
more with 3D fonts. Includes upper 
and lower case alphabet, numbers, 
and symbols. 

n Useful 3D 'primitives'— these buOding 
blocks speed up the design of large- 
scale models. 

□ Sample models and a file of Tom 
Hudson and Ian Chadwick's hints and 
tips on how to make complete digital 
scenes with CAD-3D, 



PLOTTER H 
AND PRINTER 



DRIVERS: 



AVAILABLE OCTOBEB 1ST 

ST0224 



S 24.95 




See pg. ST'^6 for Tom's CAD-3D Collection I. Only $12.00! 



n Plot your 3D drawings on a high- 
resolution pen plotter for a truly 
professional look! Supports Hewlett- 
Packard (and HP coinpatible)plotters. 
Also includes custom printer drivers 
for all popular dot-matrix printers. 

AVAILABLE OCTOBEB 1ST 

ST0225 $24.95 



A Full Function Relational DataBase 

REGENT BASE 



TM 




by Regent Software 



You don't need to be a dBase Hi program- 
mer to use this database. Perfect for the 
small business owner or for personal 
productivity and it's GEM-based. 

REGENT BASE'S procedural language 
makes it a natural for handling any small 
business need. Modules are available 
for Invoicing, Accounts Receivable, 
Checkbook Balancing, General Ledger, 
and more. 



This relational data base is written spe- 
cifically for the Atari ST. Don't settle 
for simple clones of IBM products. 
REGENT BASE is easy to use and 
state-of-the-art! 

Unique to REGENT BASE is the use of 
B+Tree indexes. Multiple fields within a 
REGENT BASE table may be indexed 
for quicker access. Use the Bridge pro- 
gram to move and merge other database 
information. Sort, file, mail-merge, select 
up-graded word processing functions, 
unlimited records and indexes per table. 

REGENT BASE runs efficiently on hard 

or floppy drive systems and supports 
15 printer types. 



Recommended— 
1 Megabyte RAM 

TH9003 



$99.95 



TOLL 
FREE 



Credit card holders, call toll-free, 24 hours-a-day 

S 800-443-0100, eXt. 133 (Continental us and Hawaii) ^ 
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Version 1.1 

by Joe Chiazzese and Alan f 



Want to take teiecom- 
munications to the 
outer iimits of your 
imagination? All you 
need is FLASH and a 
modeni to get you there. We wanted 
the ultimate in telecommunications for 
the Atari ST. And it had to be affordable. 

We couldn't wait. We built it. 
...Plus, it^ GEM-powered. 

Now you can have the automation fea- 
tures and VTIOO terminal emulation of 
Crosstalk™ on the IBM and the intuitive 
mouse/window interface of Smart- 
corn™ on the Mac. Plus, the built-in GEM- 
based word processor is integrated with 
the capture buffer— to give you a scroll- 
able, editable history of every online 
session. 

You can have ai! of it now, for under $40. 
Plus, we'll give you S15 of CompuServe 
connect time FJJEE' {Effectively bring- 
ing the cost of the software down to 
under $25!) 
FLASH features include: 



n Built-in GEM mini word processor 
(features block move, undo, search, 
merge files, and more) 

n Review your online session. Scroll 
through it at high speed— edit it, print 
it, transmit all or part of it, save al! 
or part of it to disk. Huge capture 
buffer automatically adjusts to fill 
available RAM. 



G Create "script" files that automate 
flnyoperation—tog-ons, file transfers, 
"broadcasting," email collection, etc. 
(69 powerful commands) 

□ Execute a complete online session 
with one mouse-ciick from the 
desktop. 

D ANSI VTIOO and VT52 cursor and key- 
pad editing emulation {full 24 line x80 
character smooth scrolling display), 

D CompuServe Vidtex high-resolution 
graphics terminal emulation. Save 
Vidtex graphics as DEGAS files and 
use them as clip art! 

O Supports Xmodem (CRC & Check- 
sum), DC2/DC4, and ASCII TEXT file 
transfer protocols. 

□ Ultra-reliable. FLASHfeatures6u/te?- 
proof file transfers to and from 
CompuServe {and other packet- 
network online services) at speeds 
up to 9600 baud. 

□ Extensive DOS functions at your fin- 
gertips. Two clocks: built-in real-time 
system clock and elapsed timer. 

n Unlimited banks of twenty program- 
mable function keys, which can be 
linked to script programs on disk. 

D Translation tables can independently 
filter any incoming or outgoing char- 
acters. 

□ Detailed 50-page user manual by fan 
Chadwick, including complete refer- 
ence guide. 

ST0220 $39.95 

Crosstalk'" MIcrostuf Smattcom'" Hayes 



FREE OFFER! Here's what you have 
access to on CompuServe as soon as 
you receive your copy of FLASH; 

■ ATARI16-BITFORUM:ThebestST 
PD software, support, and gossip. 

■ ATARI DEVELOPERS FORUM: 
Official Atari support, and talk of the 
trade. 



■ ANTIC ONLINE: Hot news, special 
articles never released in print. 

■ VIDTEX GRAPHICS: Hundreds of 
pictures. Everything from Hollywood 
stars to the FBI's most wanted. Outra- 
geous stuff— the ultimate clip art library! 



i 



CONTROL ACCESS 



Adds the Kermit file transfer protocol 
to FLASH. Plus, you can now call your 
computer from anywhere in the world 
and have control over: disk directory, 
send/receive Xmodem, send/receive 
Kermit, Kermit server, and upload/ 
download text files. Your system is 



secured with real password protection. 
Perfect for sales, business, and scfiool. 
Now you can use your ST from your 
office or while you're on the road. 

AVAILABLE OCTOBER 1ST 

ST0226 $24.95 

Requires FLASH 
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INTEGRATED FINANCIAL SOFTWARE FROM BATTERIES 



I INCLUDED 



THE ISGUR PORTFOLIO" 




THE ISGUR PORTFOLIO is three 
programs in one: Portfolio manager, 
telecommunications, and calendar/ 
memo pad. Receive Dow Jones stock 
quotes, CompuServe, The Source, and 
InfoGlobe financial information, auto- 
matically. Consolidate multiple stock 
portfolios. Hands on managment of 



stocks, bonds, options, commodities, 
mutual funds— your key to financial 
success. 

THE ISGUR PORTFOLIO is PC maga- 
zine's "EDITOR'S Choice." The integrated 
GEM-based system provides intuitive 
access to your data and unlimited versa- 



tility. A complete financial management 
package for the professional and 
individual investor. 

A real value for your investment. Plus, 
THE ISGUR PORTFOLIO includes 
I*STALK. Invest in your future... today. 



D.E.G.A.S 



TH9009 



$199.95 



by Tom Hudson 





DEGAS features all the artistic tools 
that you may need including: 
n Unique dual-screen GEM interface 
makes DEGAS intuitive and fun to 
use. 
D Works in any resolution. 
D Numerous functions to create and 
draw lines, rays, circles, boxes, or 
frames. Create perfectly straight lines 
or beautiful circles automaticaUy. 

PLUS ADVANCED GRAPHIC 
DESIGN FEATURES: 

n An airbrush effect that lets you con- 
trol the "paint flow." 

n Automatic "Fill" function. Fill any 
outline instantly. 

n Create "Fill" patterns. 

D Instant fVlirror Image, in any direc- 
tion. 



n Automatic Shadow or Border, you 
control the width and the angle. 

nZoom window lets you work with 
fine-detail designs. 

PLUS NOW YOU CAN INTEGRATE 
WORDS WITH YOUR VISUALS. 

D Use the Text feature to add words to 

your art. 
n Choose the character weight and size 

from various fonts, or create your 

own with the font editor. 

Now you have the power to reach the 
third dimension with your DEGAS 
pictures using the powerful CAD 3-D 
system on page ST-1. 



TH9008 



$39.95 




A spelling checker 
that is lightening fast! 

THUNDER 




THUNDER gives you a powerful spell- 
ing checker accessible from within your 
favorite application program. Your 
accuracy will skyrocket, so the time 
spent proofing will plummet. 

It's so simple. Here's how it works, 
Example: you're happily writing away 
and you make a "mstake" and BEEP 
(THUNDER picks up the error with 



iightning-fast speed}. Now THUNDER 
will display a list of similarly spelled 
words {stake, mistake, etc.) 

Compatible with Paperclip Elite, Home- 
pak, BTS, other Batteries Included 
products, 1st Word, GST-Edit, DB Master 
One, as well as FLASH on page ST-3, 
A-CALC on page ST-5, and many more 
GEM software titles. 



TIMELINK 



Take A Second 

For Time Management 



TIMELINK is a great GEM-based sched- 
uling and time-keeping tool for home 
and business. Your day, week, month and 
year appointments are only a mouse- 
click away. Useful for messages, remind- 
ers and much more. There are many 
incredible uses for the handy elegant, 
time-saving tool. 



TM 













TH9011 






$39.95 


TH9010 






$49.95 




TOLL 
FREE 


® 


Credit card hold 
S 800-443-0100, 


ers, call toll-free, 24 hours 

eXt. 133 (Continental U.S. and H 


a-day 
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The first mouse- 
driven spreadsheet 
for the Atari ST 
computer system. 
ACALC's GEM inter- 
face is exceptional. 
For example, load a 
spreadsheet simply 
by dragging the disk 
icon over the sheet 
icon. Imagine how 
easy it is to merge a 
file from disk by 
dragging the disk 
icon into the appro- 
priate cell. 



Version 1.50 

by Kuma Systems, Ltd., U.K. 

-CALC's dozens of features 
include: 

D Primarily mouse/icon 
driven. Keyboard or ten- 
key calculation entry. 
n Matfi functions include all standard 
algebraic and trignometric functions 
for performing financial and statis- 
tical analysis. 
□ Up to five windows can be open at 

once. 
n Spreadsheet capacity of 256 columns 

X 512 rows (128,000 cells). 
D Cells, blocks, rows, and columns can 
be copied, moved, saved, printed or 
deleted with the mouse, 
n Special WIDE-VIEW function permits 
half-size text display to let the user see 
more of the sheet at one time, in color 
or monochrome. 
D SEARCH for the location of any text 
string in the sheet. GOTO command 
jumps to any cell. 



g^ 




D Clipboard for temporary storage of 
block, row or column of cells which 
can be transferred to another spread- 
sheet. 

n Powerful printer formatting com- 
mands. Comes with an easy-to-use 
GEM-based printer installation pro- 
gram for any parallel or serial printer. 
Customize your spreadsheet with the 
following: 

• headers/footers 

• horizontal/vertical dividers 

• selectable form feeds 

• selectable page break 

• send printer-specific control codes 

• character translation 

• loading and saving printer 
configuration files 



n Includes on-disk spreadsheet exam- 
ples. 

D Worksheets are compatible with ail 
popular word processing software. 
Plus, A-CALC is -DIF compatible with 
other spreadsheets. 

G "Sparse matrix" spreadsheet design 
maximizes available memory. Create 
extra-large spreadsheets with RAM to 
spare. 

n Cells can be protected from tampering 
—locally or globally 

D First-ever use of "Dynamic icons" 
makes operation totally intuitive. 

D Includes illustrated manual. 



ST0212 



$59.95 



A-CH ART, THE solution for presenta- 
tion-quality graptilcs, will be avail- 
able in early October. Check for 
availability with your local retailer. 
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ARTIFICIAL 
INTELLIGENCE 

"That's right! Expert 

Systems, the artificial 

intelligence tool for 

business, industry, and 

problem-solving. The latest 

in knowledge engineering." 

EXPERT 
OPINION 




Fifth-generation. Artificial 
intelligence. Now, with 
EXPERT OPINION, you 
can be creative in this grow- 
ing new field . . .without hav- 
ing to learn a complicated language tike 
Prolog or Lisp. 

Be The First... 
EXPERT OPIIVION is the flrs^ general- 
purpose expert system creation package 
for the Atari ST. Expert systems are col- 
lections of natural language rules that 
you create, database-style. Your "knowl- 
edge bases" can be about any subject. 
EXPERT OPINION will give you new 
insight and advice about your expertise. 
And, because EXPERT OPINION uses 
the GEM interface, the system is remark- 
ably simple to use. Currently, expert sys- 
tems are used in the fields of medicine, 
computer science, economics, and 
geology. 

YOU CAN BUILD YOUR OWN KNOW- 
LEDGE BASE WITH THE INCLUDED 
MANUAL AND SUGGESTED SUPPLE- 
MENTARY READING MATERIAL. 

Mainframe Power In Your ST, . . 

Once you've built your knowledge base, 
EXPERT OPINION is easy-to-use 
because it's based on a powerful natural 
language interface, so you can give your 
input— and get your answers in plain 
English. Plus, it is the only expert system 



presently available for micro-computers 
which can clearly explain why a partic- 
ular question is being asked {it back- 
tracks up to 10 levels). 

EXPERT OPINION'S "inference 
engine" solves problems three ways: 
n DEDUCTION-Use this mode if you 
have some initial data about the 
problem {also known as Forward 
Chaining). 
n VERIFICATION OF A HYPOTH- 
ESIS— Your computer asks you ques- 
tions about your hypothesis {also 
known as Backward Chaining). 
C EXPERTISE (totally new tech- 
nique)— A combination of the above, 
for situations where you have no ini- 
tial data about the problem, and no 
hypothesis (Mixed Chaining Mode). 

EXPERT OPINION features: 

D Dictionary linked to each knowledge 

base. 
n Unlimited number of knowledge 

bases, 
n BaseManager has powerful tools for 

creating and editing knowledge 

bases. 
n Illustrated manual includes tutorial 

and tips by Christopher F. Chabris, 

Glossary, Bibliography, and more, 
G GEM-driven interface, on-line [Help], 

and user -friendly command structure 

make EXPERT OPINION simple to 

use, 



FREE BONUS! 

Comes with example knowledge bases 

on disk to get you started. 

ST0219 $99.95 

WARNING: This is a sophisticated com- 
puter science tool requiring study to use 
it effectively. We recommend the follow- 
ing books to help you use the program 
to its fullest: 

THE COGNITIVE COMPUTER, Addison 
Wesley 1984 

EXPERT SYSTEMS, Wiley Press 1985 
INTRODUCTION TO ARTIFICIAL 
INTELLIGENCE, 
Addison Wesley 1985 



THE CATALOG WANTS YOU! 
PUBLISHING OFFER. 

A New Opportunity. 

We're looking for people to create useful knowl- 
edge bases using EXPERT OPINION. If you're 
anexpertona subject (any subject), get EXPERT 
OPINION— write a knowledge base. . .Andifit's 
uery good, and has broad appeal, we'll publish 
it for you in this catalog. Write to me, Catalog 
Product Manager, formore details (my address 
is on the back page). Give me your expert 
opinions. I'll try to help you publish some of 
your knowledge bases on a commercial basis. 



TOLL 
FREE 
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Cylindrical 



by Harry Koons and David Chenette 



P 



ut yourself anywhere in the 
world — even your own 
hometown. And now view 
that land mciss from any al- 
titude—in full perspective! 



Unlimited Versatility 

The new OVERLAY feature in version 
2.0 gives you total flexibility and 
professional power. Now, plot your 
own maps in scale on top of the built-in 
world mop database. Or use the new 
DATAMAP disks to add the boundaries 
of the nations of the world, historical 
maps, and more. 

Tap Your ST's Speed. . . 

Using advanced CAD system algorithms, 
MAPS and LEGENDS takes less than a 
minute to do what used to take hours for 
computers— and weeks by hand. It fea- 
tures uitra-fast drawing of world maps 
from one of 11 perspectives, three reso- 
lutions, up to 16 colors. 



ENTIRELY GEM-BASED 
FEATURES INCLUDE: 

D OVERLAY option for plotting your 
own maps, flight plans, routes, city 
locations, etc. 

D BUILT-IN DRAWING TOOLS 
" Multiple Pattern Fills, Pen sizes. 
Text sizes, Fonts 

n MULTI-FONT DESK ACCESSORY 

• Comes with extra fonts for cus- 
tomized legends 

n AUTO-LOCATE MODE 

• Reads geographic coordinates 
from map, and distance and bear- 
ing from any point on the Earth- 
just by pointing with your mouse! 

□ DEGAS and Neo compatible. Use 
your maps as basic elements in the 
most popular ST graphics packages. 

□ Works with color and monochrome 
systems. 

D Built-in topic-based [Help] system. 

NOTE: With the new overlay enhance- 
ment, MAPS and LEGENDS has become 
one of the best cartographers tools in 
history. We added this capability to the 
system after a request for it from a navi- 
gational flight officer. He told us that he 
and the other flight officers at his base 
were using MAPS and LEGENDS and 
ST's to draw their flight plans, and that 



they needed to be able to accurately plot 
their routes. We liked the idea so much 
that now anyone can build custom map 
databases out of simple coordinate lists. 
And arguably the best thing about ver- 
sion 2.0 is the price. ..still $34.95. 



ST0202 



$34.95 



INTRODUCING DATAMAPS 

DATAMAP mW 
COLLECTION I: 



NATIONAL POLITICAL 
BOUNDARIES 

Europe, Latin America, S. America, 
Asia, Africa 

PROVINCIAL AND STATE 
BOUNDARIES 

Australia, Canada, Cliina, US.S.R. (tlie 
SSR's) 

HISTORICAL MAPS 

PreWorldWar I Europe, Pre World War 
11 Europe, Original 13 U.S. colonies, and 
more... 

Requires Maps and Legend 2.0 
ST0227 $24.95 

THE CATALOG ST 7 




Exciting World War II Submarine Action 
In the Soutfi Paclfici 



TT.\f i M ^B 
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By MicroProse 



0400 hours, Tuesday, August 12, 
1942 . . .BATTLE STATIONS!! BATTLE 
STATIONSIl Enemy convoy Identified 
on radarl! 

SILENT SERVICE, The Submarine 
Simulation, brings exciting action, great 
strategy, detailed graphics and an ultra- 
realistic simulation of World War 11 
U.S. submarine action in the South 
Pacific. 

SILENT SERVICE'S outstanding 
features include: all the critical battle sta- 
tions, engine room, conning tower and 
ship's bridge; challenging and realistic 
combat versus single ships and heavily 
escorted convoys; and an infinite vari- 
ety of situations using complete maps 
and charts for the entire Southwest 



Pacific and a sophisticated and realistic 

attack plotting system. 

SILENT SERVICE provides a wide 
selection of historic scenarios. From hit- 
and-run attacks to patrol missions that 
bring challenge and fun to both the first 
time player and the experienced subma- 
rine veteran. 

As captain, you select a quiet patrol 
sector in the Marianas Islands, or choose 
the dangerous waters off the coast of 
Japan. Is the submerged daylight peri- 
scope attack best, or do you charge in 
on the surface at night using only radar 
bearings as your guide? These and many 
more decisions will determine your 
place among the elite ranks of the 
SILENT SERVICE. 



TH9016 



$39.95 





I 



GET ORGANIZED AND HAVE FUN WITH MICHTRON 



Eliminate the 
desk battlefield 

and nnake 
organizing easy! 

What Sidekick did for the IBM, COR- 
NERMAN does better for your Atari ST 
This utility gives you a host of useful 
desk-top tools in one simple, neat pack- 
age. With everything from a built-in 
clock, notepad, phone book and ASCII 
table, to a full function calculator, a clut- 
tered desk is a thing of the past, And as 
a desktop accessory, CORNERMAN is 
available nearly anywhere within GEM. 
CORNERMAN doesn't interfere with 
other programs and comes complete 
with security HIRE THE PERFECT 
RIGHT HAND PERSON TODAY- 
HIRE CORNERMAN. 

One megabyte RAM recommended, 

TH9013 $49.96 



CARD games for the entire family and 
serious strategy card player. Beat the 
dealer in Blackjack, skunk your oppo- 
nent in Cribbage, play out the aces in 
Solitaire and win at Klondike and Poker 
Squares. Incredible graphics, 



TH9015 




Now you're organized- 

so take a break 

and have some fun. 



The arcade adventure takes you to the 
world of the biggest, fastest, most 
detailed game ever designed for a home 
computer. You're the bandit rogue travel- 
ling through time and space. The quest 
always beckons: recover the Great 
Artifacts and break the Gates of Time! 
Features; 16 unique arcade lands, 3,000 
screens, realistic detail, three text ad- 
ventures, unique dual-player mode Uses 
color monitor. 



$39.95 TH9014 



$39.95 



IHichYron 



TOLL 
FREE 



Credit card holders, call toll-free, 24 hours-a-day 
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ALERT 



Written by Stanley Crane 
and Daniel Matejka 









:5> 



ul you 
have some 
options. A 
few. Stra- 
tegically- 
placed Ground-Based 
Lasers and Antiballistlc 
Missile Silos are the 
backbone of your de- 
fense, Your last space- 
based Particle Beam 
Weapon is available, 
but you must allocate 
your resources wisely 
to use it. 



Your cities are under attack. It's up to you to try and des- 
troy the Russian ICBM's and MlRV's— plus the missiles launched 
from nuclear subs. RED ALERT features real-time animation, 
on-screen help, auto-demo mode, color/monochrome compati- 
bility, three selectable levels of play, PLUS a unique construc- 
tion set which lets you customize North America with the cities 
that you want to protect, and the positions of the Ground-Based 
Lasers and Antiballistlc Missile Silos. 




ST0223 



$24.95 



By Harry Koons 

ow your ST can instantly generate accurate natal 
charts for you, your family, and friends— the way 
an astrologer would do it. Entirely GEM-based, 
STAR STRUCK creates charts using formulas 
for the nine most popular house systems used 
throughout history (Piacidus, Morinus, Equal Spaced, 
Porphory, and five more). On-screen help windows and refer- 
ence documentation show you exactly what all of the astro- 
logical icons mean. 



NOTE: RED ALERT is an addicting game, but it's also a 
thought-provoking version of an SDl (Strategic Defense Initia- 
tive) nightmare scenario, (RED ALERT was developed by the 
authors of DO Master.) 




Excellent Graphics, Custom Fonts... 

STAR STRUCK includes the Font Loader desk accessoi 
fonts (gothic. roman, etc.) to give your charts that autii 
look. All astrological aspects are displayed in graphic 
U.S. and world maps are built into the program. Locate your 
birthplace with the mouse or key-in the exact coordinates. 
Charts can be printed out or saved to disk in DEGAS format. 
Compatible with color and monochrome monitors. 
ST0222 $24.95 
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GRAPHICS PROGRAMMING WITH GSTC 



GSTC APPLICATION FOUNDATION I 
FRACTAL FACTORY " 




Discover how to do graphics program- 
ming! Learn how to write a GEM appli- 
cation! Learn by example wit h the source 
code for FRACTAL FACTORY. This re- 
markable disk contains all the source 
code, batch files, linker files, and graphics 
and math libraries for a unique graphics 
application written by the GST in-house 
programmers. FRACTAL FACTORY is 
the ultimate fractal -maker, using multi- 
pie windows, variable zoom, and con- 



touring to display many generations of 
dazzling fractals at once. Monochrome 
and Color versions illustrate how to write " 
GEM graphics applications for both types 
of monitors. The FRACTAL FACTORY 
source code can be the foundation for 
almost any type of GEM application writ- 
ten in GSTC. 



ST0228 



$49.95 



Sixty Eight K Assembler, Editor, Debugger combo 
for under $35.00! 



A-SEKA"^ 

by Kuma 

Version 1.6 

By Andelos Systems/Kuma, UK 



Sometimes you just need to get that code 
running faster. A high-level language 
application needs a burst of energy. Or 
maybe it s arcade action— high end stuff. 
A-SEKA does it fast, because it is all in 
RAM. All of it: The Assembler, Editor and 
Monitor/Debugger. Those who know 
how can create exciting codes mighty 
fast. And if you're learning Assembly, you 
won't ever have to wait for your latest 
attempt to go through the assemble and 
link process. 



A-SEKA assembles source codes at over 
30.000 lines per minute! And since it can 
assemble and link simultaneously, you 
can run your code instantly. Of course, 
A-SEKA is also a macro assembler and 
usesstandard Motorola mnemonics. But 
what really sets it apart is its powerful 
machine language monitor, disassem- 
bler and symbolic debugger. 

FEATURES: 

D Symbol table access. 

D Arithmetic operations. Input in 

any base. 
D Disassembles 16 lines at a time. 
D Motorola mnemonics. 
n Single step. Trace. 
n Multiple breakpoints. Memory inspect 

and modify. 
n Line assembler 
D Examine registers. 



VERSION 1.6 
ENHANCEMENTS: 

□ Full-screen editor, including cut & 
paste 

□ ExpandedGEMAESandVDIlibraries 
D Compatibility with other assembler 

source code 

n Support for GEM subdirectories, addi- 
tional pseudo-op's for printer and Line 
A control 

D Step command now skips trap and 
Line A OS calls 



ST0216 



S34.95 



NOTE: We're carrying both the SEKA 
and GST-ASM assemblers because they 
are complimentary — each is designed 
to meet the needs of a different type of 
programming. SEKA is a low-level 
assembler that is most useful for pro- 
grammers who like to work entirely at 
the machine level or want ultra-fast 
response time. GST-ASM is really a pro- 
fessional developers tool— its extra GEM 
features and GEM environment make it 
the perfect assembler to use with any 
high-level language. 



A-RAA/r 

by Kuma 

By Roddy Pratt, UK 

Can your RAMdisk partition any size 
disk emulator you want? 



DA-RAM can. 

Can it work with TOS in ROM? 
DA-RAM can. 

Can your RAMdisk accelerate your 
floppy write speed by turning off the 
verify mode? 
D A-RAM can. 

Can you have multiple RAMdisks pres- 
ent at the same time? 
D You guessed it. A-RAM can. 



A RAMdisk is an area of memory set 
aside as a buffer that responds to most of 
the available disk commands— only 
much faster Everybody needs a great 
RAMdisk, and A-RAM is powerful, 
simple and flexible enough for every 
application. 



ST0215 



$19.95 



TOLL 
FREE 
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FINALLYI GBM DEVELOPMENT AND LEARNING TOOLS AT A SUPER VALUEI 

GSTC" Compiler 



Here is the compiler 
that 1ST WORD was 
written in. 



Do you want to write GEM-based pro- 
grams for the Atari ST? With GSTC 
you can— without spending hundreds of 
dollars on expensive compilers. Now 
you can add windows, dialogs, and alt 
the GEM forms to any program — it's 
easy with GSTC. Use your mouse and 
pull-down menus to write C programs 
within a desktop menu-driven "shell" 
environment, GSTC allows compile- 
assemble-link and assemble-link oper- 
ations to be batched, avoiding tedious 
and error-prone command line entry. 
And it all fits on one single-sided disk. 
No excessive disk swaps. 



Version 1.3 

At the heart of the GSTC package is 
the remarkable GEM Superstructure 
Library. This enables the beginner to 
write GEM applications software at 
once, without the complex learning 
curve associated with GEM AES and 
VDl. Open a fully-functioning window 
with one call. GSTC is fast— providing 
compile and linkage turn-around times 
speedy enough for the most impatient 
hacker! 

GSTC features include: 

D GEM Text Editor (GST EDIT) 

D Linker (GST LINK) 

D C Compiler 

D GEM "shell" 

D 68000 Assembler 

n GEM Superstructure Library 

n GEM bindings, (Standard Unix, GEM 

VDI, GEM AES, GEM XBIOS, TOS) 
□ Comprehensive printed user manual 

Version 1.3 enhancements 

DAI! 40 GEM XBIOS routines, with 
documentation 



DAli 12 GEM BIOS routines, with 

documentation 
D Hints and Tips on using pointers to 

simulate structures 
D FRACTAL FACTORY object code 



TH9018 



$79.95 



NOTE: We searched all over the world 
to find the best introductory C compiler. 
When we discovered that GSTC was 
used to write 1ST WORD, we decided 
that it was just whatwewerelookingfor. 
This compiler is very powerful and re- 
markably easy to use. But at present, it 
doesn't have structures or a floating 
point library. To help you here, our ver- 
sion 1.3 of the GSTC documentation 
includes information about how to simu- 
late structures with pointers, and the 
FRACTAL FACTORY disk has a math 
library on it. If you're writing a program 
that uses very serious math, you may 
need to look at Lattice C. But for most 
applications, GSTC will do the job. 



GST-ASM™ 



A high-level 
Macro Assembler 
with an unbeatable 
combination of 
price, performance, 
and features, 



Elegance and sophistication . . . 
GST-ASM 



GST-ASM is a Motorola-compatible 
68000 macro assembler designed to 
work with high-level languages (C, Pas- 
cal, Fortran, etc.). Now, assembly lan- 
guage programming is truly accessible 
to all ST users. And because GST-ASM 
uses the GST GEM interface and text edi- 
tor, it's a joy for beginner and advanced 
programmers alike. 

Includes Macro Tools and morel 

GST-ASM has high-powered macro facil- 
ities, for extremely fast throughput. Pius, 



FREE WITH GSTC & GST-ASM! 
GST EDIT and GST LINK 



GST-EDIT is a GEM-based screen editor 
that is to programming, what 1ST WORD 
is to word processing. Features up to four 
independent windows, cut & paste, 
search & replace , plus is 100% integrated 
with GSTC and GST-ASM. 



GST LINK is the same linker that comes 
with Lattice C. It is an extremely flexi- 
ble linker that is relocatable, supports 
SID symbols, symbol tables, link maps, 
batch control files, and more. 



extended macro functions include 
several 'pseudo-functions' such as .LEN 
and .INSTR (which can be used in string 
substitutions). A large toolkit of useful 
macros is included for conditionals, loops, 
stack handling, and subroutines. 



GST-ASM features include: 

D GEM text editor (GST EDIT) 

n GEM "shell" operating environment 

n Unique, high level instruction macro 

library (IF, WHILE, REPEAT CASE, 

etc.) 
D Supports conditional assembly 
n Creates cross-reference listings 
n Symbol table 
n Supports Include files 

□ Generates relocatable code 

□ Produces object code compatible 
with: Lattice C, Pascal, Fortran, 
ModuIa2, etc. 

□ Comprehensive printed user manual, 
including thorough documentation of 
all assembler error messages. 



TH9017 



$59.95 
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The standard tor ttte 68000. 

LATTICE C" 



D Full Kernighan and Ritchie implemen- 
tation 

D Powerful data types (pointers, arrays, 
structures, unions) 

□ Separate and conditional compilation 
G Macros 

D LATTICE design 

n TVue native code compiler 

D Comprehensive error handling, in- 
cluding warning messages 

n Full floating point arithmetic 

n Optimized to produce fast, compact 
code 

□ No runtime licenses required 

D All C language features are supported, 
including: 



By Metacomco 

PRE-PROCESSOR COMMANDS: 

^include, *define, *undef, *if, 
*ifdef, #ifndef, #else, ^endif, «line. 
STORAGE CLASSES: extern, 
static, auto, register, typedef. 
TYPE DECLARATORS: inl, char, 
short, unsigned, long, float, double, 
struct, union. 

OBJECT MODIFIERS:, .[ ], ( ). 
Declarations may be arbitrarily 
complex. 

INITIALIZERS: Full range of 
expressions accepted. 
STATEMENT TYPES: All are sup- 
ported, including labels and goto. 
D LINK 68 and GST LINK compatibility. 



GEM Libraries 

n Complete interface to GEM VDI and 
AES functions and to library of Unix 

andutility functions, allowingall the 
features of the Atari ST— icons, win- 
dows, graphics, etc.— to be used. The 
graphics libraries are also included in. 
source code form. 
□ 270-page manual 

EDITOR UNKER MENU+ 

TH9007 




MCC PASCAL" 



ISO Pascal Compiler 

This Pascal compiler has been widely 
used on the Commodore Amiga and the 
Sinclair QL. It is a fast and powerful 
implementation that conforms fully to 
the exacting ISO 7185 standard. MCC 
PASCAL is the ideal Pascal for all users, 
whether new to Pascal or experienced 
programmers. 



By Metacomco 

a FAST, SINGLE-PASS COMPILATION. 
MCC PASCAL compilation is 
straightforward and fast- ideal in 
education or program development. 

D COMPATIBLE-COMPLETE IMPLE- 
MENTATION OF ISO 7185. Compati- 
bility with the International Standards 
Organization's definition of ISO Pascal. 

n 32-BlT INTEGERS AND 32-BlT IEEE 
FLOATING POINT 




D COMPREHENSIVE ERROR HAN- 
DLING. The compiler recognizes 
over 150 different errors, and the run- 
time system provides over 30 differ- 
ent English error messages. 

D 215-PAGE MANUAL. 

EDITOR LINKER MENU+ 

TH9006 S99.95 



I 



"For an environment that's superb for development, 
I vote for Metacomco." 

Anila Sinclair, MagneHc Scrolls, UK 

UeKlopenafTHEPAWm 



FREE WITH EACH 

METACOMCO LANGUAGE 

SCREEN EDITOR, LINKER, MENU+ 



nEDUORfeatures include: Horizontal 
and vertical scrolling, file merging, cut 
& paste, search & replace, macros. 

□ LINKER features include: Relocata- 
ble, optional SID debugger symbols, 
auto run-time relocation, 

□ MENLH- is a remarkable new menu- 
driven GEM environment designed to 



speed up your program development 
cycle (EDIT, COMPILE, LINK, RUN). 
You can now specify a number of 
TOOLS (for example, any editor, com- 
piler, debugger, etc.) together with the 
options for each of these tools. And 
MENU+ remembers all the little 
things that you do during a program- 
ming session— so you don't have to. 
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MCC MACRO 
ASSEMBLER 

By Metacomco 

The MCC MACRO ASSEMBLER is the 
companion assembler for Lattice C and 
MCC Pascal. This full-specification assem- 
bler was specif ically designed to comple- 
ment those languages. Features include; 
linker, editor, GEM libraries, macros, 
Menu-t- and 100-page manual. 

$79.95 



TH9005 



Technical questions? 

Talk with a Metacomco 

System Software 

Engineer: 

Call (408) 438-7201. 
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ICONS 
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By Jim Thompson 
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These are the DOS Icons Digital 
Research forgot when they wrote GEM. 
It's too bad Atari didn't put CRYSTAL 
into the TOS ROM's, because for less than 
30K of code, CRYSTAL gives TOS the 



most powerful features of MS-DOS. Plus, 
you never lose the look and feel of GEM. 
And since CRYSTAL is a desk accessory, 
it's always available. 
In fact, these eight icons will eliminate 



all the frustration you feel from not hav- 
ing powerful DOS functions available 
from within your favorite GEM program 
(or the desktop). 

Of course, CRYSTAL is compatible 
with at! monitors, all disk drives, and al! 
printers. 

Make your persona! version of GEM 
shine— for $24.95. 



ST0229 



$24.95 



Use the language that professionals use from Prospero—fhe language specialist 

PRO Fom-RAN-?? 



PRO FORTRAN-77 compiles up to 
10,000 lines and utilizes over 1 ,000 iden- 
tifiers. Pro Fortran-77 is a full implemen- 
tation of ANSI (American National 
Standards institute) Fortran 77 with no 
omissions and many useful extensions. 

PRO FORTRAN-77 gives program- 
mers a secure base on which to build, 



Package includes: compiler, linker, run- 
time libraries, librarian, X-ref program, 
sample programs and 200 page manual. 

Fortran is the most widely used language 
by universities, scientists and profes- 
sional programmers. Take advantage of 
Fortran power combined with the 
wealth of information and subroutines 
that have been developed over the past 
25 years. There is software for every- 
thing from particle physics to mechan- 
ical engineering. 



Idea! for Atari software developers, 
schools and colleges, computer science 
students, training institutions and great 
for solving technical problems. 

Fortran should be in every ST program- 
mers library. 

TH9012 $149.95 
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A bit-map 'raster cutter' for ST program designers 
using the 16-color mode. 

ao.LR. 

Object Editor 



by The Rugby Circle 



NOW, the first ail purpose graphics 
design programming package is availa- 
ble [or the ST. An essential time-saving 
tool developed for creating software 
sprites and bit-mapped game objects. 

Your original art or favorite low-reso- 
lution picture from any ST paint pro- 
gram can be sketched or modified. 
Invert, twist or copy your objects. The 
zoom editing feature gives your picture 
that professional look. Your object is 
stored on disk in a compatible format al- 
lowing you to access your work from the 
programming language of your choice. 



Store up to 20 objects in memory at once 
and instantly access four rainbow paint 
palettes from RAM. 

C.O.L.R. OBJECT EDITOR includes 

object motion examples. This is the only 
graphics programming tool of its kind 
for the professional and hobbyist 
programmer. 

See the November 1985 issue of ANTIC 
for more information on C.O.L.R, 
OBJECT EDITOR. 

COLOR ONLY 

ST0201 $29.95 



DISK DOCTOR 




by Dan Matejka 



^^1*S«^^^*' 



Learn the secrets of ST disk structure, and 
if you're adventurous, try some "disk 
archeology." Recover deleted files auto- 
matically and repair damaged files and 



□ Make quick modifications to any ST 
single or double-sided floppy or hard 
disk. 



G Use DISK DOCTOR to customize 

program menus and messages. 
D Search for character strings or go to 
any sector instantly. Quickly edit full 
sectors on-screen usingyour mouse or 
cursor keys. Get directory history, file 
attributes, and more. 

DISK DOCTOR is perfect for the casual 

user who just wants to repair a file, OR 
the serious programmer who wants to 
discover what's really going on. Includes 
on-disk Help and thorough technical 
reference information. 

COLOR / MONOCHROME 

ST0211 S29.95 
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ULTIMA II 



By Sierra 



ULTIMA II. One of the most popular 
fantasy role-playing games ever, 
ULTIMA II still claims a place on the 
bestselling charts. Second in the series 
this multiple disk epic that lets you cre- 
ate your own super-powered alter ego 
to perform brave and daring feats in 
your honor. Together, step through time 
doors to ages past, present and future. 
Explore the far reaches of the galaxy. 
Battle fierce monsters and cunning 
brigands. Finally, face the all-powerful 






enchantress Minax, in a duel unequaled 
in the annals of time. A colorful cioth 
map helps guide the player through the 
Ultima universe. 

Plan on spending a couple weeks 
unravelling the ribald adventure. 




HARD TO FIND 
CABLES $ia95 




520 ST 

6' ST Micro floppy disk drive cable 
(SF354 and SF314 drives) 
PH0003 $19.95 
6' ST to printer cable 
PH0001 $19.95 
5' ST to modem cable 
PH0002 $19.95 



THE CATALOG has premium quality 
shielded cables with gold contacts. 

What makes these cables so special? 
They have the unique non-standard 
Atari connectors and provide the length 
that can free-up your workstation of 
awkward peripheral arrangements. 

800/XL/XE 

10' Atari standard peripheral cable 

(Serial /SIO connector) 

PH0006 $19.95 

5' 850 Interface to printer cable 

PH0004 $19.95 

5' 850 Interface to modem cable 

PH0005 $19.95 



HIPPOVISION 
VIDEO DIGITIZER 



Create digitized Degas and NEO- 
chrome-compatible picture files using 
any high quality composite video input 
(e.g. color or b&w camera, VCR, TV, 
etc....}. Fast software updates the ST's 
screen 10 times per second, while the 
hardware frame-grabber snaps pictures 
in 1/60 of a second. Animation mode 
allows automatic sequential frame digiti- 
zation. Black and white high contrast 
mode or up to 16 grey levels with color 
monitors. 320H x 250V resolution. 
NTSC, PAL, and SECAM compatible. 
Includes hardware interface, software, 
demos and instructions. 

Perfect for artists, game designers, and 
video aficionados. 



In single color mode: It snaps the 
picture in a single video frame (l/60th 
of a second). No blurring of the picture 
occurs in this mode. Animate a 
sequence of pictures (up to a total of 
50 pictures with a 512K machine, 
about 100 for a 1024K machine). 



THE SPECS 

n 256 X 256 X 9 bit resolution {3 bits per 
color). 

D Standard NTSC 1 volt peak-to-peak 
composite sync signal. 

D Software color "voting" system picks 
optimum 16-color ST palette accord- 
ing to image. 




D Hardware plugs into printer port for 
high speed data transfer rate. 



$139.95 



THE CATALOG 



ST PUBLIC DOMAIN ilBRftiffi 



S/Terminal plus SOURCE! 

Get on-line and transfer files with S/Termi- 
nal, a full-featured terminal program written 
in 68000 assembly language. S/Terminal fea- 
tures Xmodem. Xon/Xoff, 300/1200/2400 
baud support (and more, up to 19, 2K baud), 
and on-line help screen. ALL SOURCE 
CODE IS INCLUDED, in addition to object 
code. This disk also includes several C source 
and object graphic examples, plusfive LOGO 



PD0057 



$12.00 



ST DOODLE plus SOURCE 

The perfect GEIVI learning tool. PD paint pro- 
gram written in "C", including object and 
source files for you to explore, Works in all 
three resolution modes. Demonstrates GEM 
drop-down menus, windows, scroll bars, 
color selection, fill algorithm, three brush 
sizes. Comes with NEOVERT— converts 
your pictures from NEOto DOODLEformat. 
Learn howGEM andthe ST work , . .with- 
out any typing! 
PD0058 $12.00 

DEGAS COMPETITION COLOR 
WINNERS 

The top eight color entries from Batteries In- 
cluded's DEGAS art competition. Includes 
a slide-show viewing program — DEGAS is 



ST FRACTALS pLs SOURCE! 

Features MANDLEZOOM by Harry Koons. 
Uses Mandelbrot algorithm to draw fractals 
in GEM windows in any resolution. Then 
zoom in with 2x,4x,8>:,or16x magnifi- 
cation. Change fractal iteration values and 
rescale fractals to enhance their color. Then 
save your fractal picture to disk. Includes all 
"C" source and object files. PLUS, a half 
dozen other fractal programs that use differ- 
ent algorithms and display techniques (some 
also with source code). 
PD0068 $12.00 

DEGAS COIVIPETITION HI RES 
WINNERS 

The top eight monochrome entries from 
Batteries Included's DEGAS art competi- 
tion. Includes a slide-show viewing pro- 
gram— DEGAS is not required. 
PD0076 



CAD-3D COLLECTION I 

The first collection of complex objects 
created by Tom Hudson with CAD-3D. In- 
cludes: MONITOR (Atari SM124 monitor), 
ALPHOM (Alpha when viewed from one 
angle, Omega when viewed from another!), 
STARSHIP (Starship Enterprise), SHUTTLE 
(Executive Space Shuttle), OUTLET (ex- 
ploded view of electrical wall outlet), HEL- 
MET (16th century Japanese battle helmet), 
and more! (requires CAD-3D ST0214) 
PD0085 $12.00 



An Electronic Jewish Moif^er 

Created by a Former Playboy Cartoonist! 

Written by Yakov Kirschen and Just For You, Inc. 

MOM MURRAY 
and ME and ME 



Just think. Your own computerized 
Jewish mother— on-screen in an over- 
stuffed chair; knitting, cajoling, dis- 
pensing advice, and offering you 
encouragement— or making you feel 
guilty, of course. She'll speak to you 
by name and brag about you to your 
friends. 



ST0204 
monochrome /color 



$19.95 



Some people don't want a Jewish 
mother. How 'bout a Jewish uncle? 
The London Times called MURRAY "the 
first in a new generation of Biotoons" — 
computerized, interactive cartoon 
characters, MURRAY is always ready to 
cheer you up when you're feeiing blue. 



ST0203 
monochrome/color 



$12.00 



ST BASIC/LOGO SAMPLER 

BASIC: Includes Ml DIREC.BAS -a simple 
MIDI sequencer and sample song files, 
BG.BAS-backgammon, Fractals in BASIC, 
Biorythm's, and more. LOGO; Nearly a 
dozen useful routines including complex 
graphics. Plus two bonus desk accessories, 
PD0D78 $12.00 



SOLID SOURCE CODE 

Features Jim Luczak's VDI SAMPLER and 
C PRIMER, which demonstrates C program- 
ming techniques and the use of VDI func- 
tions and their C BINDINGS. BICALC, a 
desk accessory Binary-Hexadecimal-Deci- 
mal calculator. Plus two very fast versions of 
LIFE, written in Assembler. All source and 
object code is included and is well com- 
mented. And more! 
PD0079 $12.00 

XLISP 0^f 

Interested in artificial intelligence? XLISP is 
a version of LISP that has an object oriented 
extension capability. It allows you to experi- 
ment with Al algorithms and structures as 
well as object oriented programming. Appli- 
cations written on the ST can be ported to 
other computers since versions of XLISP are 
also running under UNIX, VAX/VMS, 
MD-DOS, CP/M-86, CP/M-68, and Mac- 
intosh. XLISP comes with SOURCE CODE 
(in CI and is extensible. 
PD0084 $12.00 



Special Note 
To ST Dealers 

When it comes to Atariia bit prod- 
ucts, THB CATALOG is ttie best 
resource available for state-of-the 
art software. Every effort tias been 
made to contact ST dealers 
nationwide with a copy of THe 
CATALOG ttiat features ttie latest 
in ST products. If you were over- 
looked, It was not intentional, and 
we tiope you will coll us for free 
product Informotion and dealer 
discounts. Be one of ttie first to 
stock your shelves with ST products 
from Antic, Batteries Included, 
Regent, Hippopotamus. GST, Kuma 
,..and the list continues. 
Many of our customers coll us look- 
ing for the nearest dealer of ST 
products. If you would like to be 
on our referral list please let us 
know. We're here to help you 
service the many ST owners. ..and 
Ihelistisgrowingl 



TOLL 
FREE 



Credit card holders, call toll-free, 24 hours-a-day 

S 800-443-0100, eXt. 133 (Contmentel us. and Hawaii) 9 



ORDERS 
ONLY! 



THE CATALOG 



